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はじめに 



本醫 * プログラム 開発 ツール マニュアル" では， マクロ アセンブリ 言語に よる プログラム 開 
発 を 中心に， そこで 用いる 各種 ユーティリティの 解説 を 行って います. マイクロ ソフト マクロ 

アセンブラ ：MASM の 文法な どの 詳細な 解説 は 、、マクロ アセンブラ ユーザーズ/ リ ファレ 
ンス マニュアル （マクロ アセンブラ パッケージ 添付 广 で 行って います. 

本章で は， プログラム 開発に 関係す る ファイルの 種類， 本 害で 用いて いる 表記法な どの 解説 
を 行って います. 



1.1 ファイル 構成 



本 害で 解説す る プログラム 開発に 閱連 する ユー ティ リ ティ として は， つぎの ような ファイル 
があります. 



LINK.EXE 
SYMDEB . EXE 
MAPSYM . EXE 
LIB . EXE 
MAKE . EXE ^ 



リンカ ユーティリティ 
シン ボリ ック デバッガ 
シンボル マップ ユー ティ リ ティ 

ライブラリ マネージャ 
プログラム メイン テナ 



本 害で は， 上記の 各 ユーティリティ プログラム について， 用途 • 使用方法 など を 扱って いま 



す. 
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1.2 MASM の 利用に あたって 

マイク ロソフ トマ クロ アセンブラ （MASM) は， 8086Z286/386 マイ クロ プロセッサ フ ァ ミ 
リーの ための， マクロ アセンブリ 言語です. 

マクロ アセンブラで プログラム を 開発す るに は， マクロ アセンブリ 言語の 正しい 文法と ソー 
ス ファイルの 害 式， それ を 記述す る エディタの 操作 方法に 関する 予備知識 を 必要と します • ま 
た， 8086/286/386 マイクロ プロセッサ ファミリーの 機能と 命令 （インストラクション） セッ 
トに閲 する 知識 も 必要です. 

ユーザ一 は， MASM を 用いる ことによ り， 8086 マイクロ プロセッサの セグメ ント ァーキ テク 
チヤ を 理想的に 論理的に 扱う ことができます. この MASM の 文法， ディ レク ティブ， オペ ラン 
ド， 用例な ど は， や マクロ アセンブラ ユーザーズ/リファレンス マニュアル クを 参照して くだ 
さい， 

マイク ロソフ トマ クロ アセンブラ は， 8086/286/386 マイクロ プロセッサ フ アミ リーの， す 
ベての 命令 （インストラクション） セット を サポート しています. したがって， 8088， 8086， 
80286, 386 の マイクロ プロセッサ， および オプションで 8087, 80287 数値 演算 プロセッサ を 
使用す る コンピュータ について アセンブリ プログラム を 開発す る ことができます. や マクロ ァ 
セン ブラ ユーザーズ ノ リファレンス マニュアル かに は， ユーザーの 便の ために， これらの プロ 
セッサ の， すべての 命令 （インストラクション） の 書式と 機能 を 掲載して います • 

洤 意 

マイクロ ソフト マクロ アセンブラ （MASM) と マクロ アセンブラ ユーザーズ/ リ ファレン 
ス マニュアル は， 別売り の マクロ アセンブラ パッケージに 添付され ています， 

1.3 開発 手順と ユーティリティの 用途 

アセンブリ プログラムの ソースファイルの 作成から， 実際に 動く （実行可能な） プログラム 

が 完成す る ま での 手順 は， つぎの ような 4 段階に 分けて 考え る ことができ ま す. 

1. エディタ によって， アセンブリ プログラムの ソースファイル を 作る. 

2- MASM (マクロ アセンブラ） によって， ソース プログラム を アセンブル する. 

3. LINK (リ ンカ） によって， 別に 開発して いた ルーチン や ライ ブラ リファイ ルの ルーチン 
と 結合し， 実行可能な プログラム を 生成す る. 

4. SYMDEB (シンボリック デバッガ） によって， プログラム を 検証 • テストす る. 

前記の 他に 用意され た ユー ティ リ ティ は， つぎの ような 用途に 用います. 

MAKE (プログラム メイン テナ） を 用いる と， これらの 4 段階の それぞれで 行う コマンド 入 
力 を 一括して， 自動 化する ことができます. 
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MAPSYM は， SYMDEB で デバッグ するとき に 用いる， シンボル マップ ファイル を 作成す 
ると きに 用います. 

CREF (クロス リファレンサ） は， デバッグ 処理の 助けと なる もので， プログラム 中の すべて 
の シンボルの クロス リ ファレン ス リス トを 作成し ます • 

LIB (ライ ブラ リ マネージャ） は， リ ンクの 際に 用いる ライ ブラ リ ファイル を 管理す る もので， 
ユーザー 独自の ライ ブラ リ ファイル を 作成したり， ライブラリ ファイルの 内容 や 構造 を 変更す 
る ときに 用います. 

最後の テス トを 終了した プログラム は， MS-DOS コマンド として， いつでも 利用す る ことが 
できます. ユーザーが 開発した プログラム も， MS-DOS で 供給され る プログラム （コマンド） 
と 同様に， コマンド パラメータ を 受け付ける ことができ， バッチ ファイルの 中で も 利用す る こ 
とがで きます， 

1.4 本 害で 用いる 表記法 

この マニュアル では， つぎの ような 表記法 を 用いて います. 

表 記 意 味 

CAPS 大文字の アルファベット は， 表記され ている とおりに 入力す る， コマンド 名， ノ、。 
ラ メータな ど を 表します. なお 通常， 大文字 Z 小文字 は どちらで も 同様に 扱われ 
ます. 

< > 山形 カツ コは， その 位置に 入力す る 項目 を 表します. たとえば， く ファイル 名〉 と 
いうと ころで は， ユーザーの 作成した ファイルの 名前 を 入力し ます. 

[ ] 角 形 カツ コは， 入力 を 省略で きる 項目 を 表します. 省略した 場合 は， システムで 
あらかじめ 設定して いた 処理が 行われます. 

I 縦線 は， 選択項目の 区切り を 表します. この 記号で 区切られた 項目の 中から， 必 

要な もの を 選んで 入力す る こと を 表します. 

… 緣り 返し 記号. 必要に応じて， 項目 を緣り 返し 入力す る こと を 表します. 

I 1 枠で 囲まれた 文字 は， キーボード 上の 特定の キー を 示します. たとえば， [^53 
は コントロール キー を 表します • また， 回の ような 表記 は， [^ro キー 
を 押しながら 回 キー も 押す こと を 表します. 

カンマ （，）， コロン （ ： ）， セミコロン （ ： ）， スラッシュ （/), ィ コール 記号 （=) などの 
記号 類と スペース （空白） は， コマンド などの 害 式 （文法） の 一部です. 表記され ている 位置 
に， 正確に 入力して ください. なお， 省略で きる 項目 は， 該当 箇所で 解説され ています. 



LINK •• リンカ 

2.1 イントロダクション 

マイク ロソフ トリ ン 力： LINK は， マクロ アセンブラ MASM または C， Pascsl のよう な 高級 
言語 コンパイラ によって 生成され たォ ブジェク ト コードから， 実行可能 プログラム を 作成し ま 

す. 

ユーザー は， MS-DOS コマンド 行 上で この ファイルの 名前 を タイプす る ことよって， この プ 
ログ ラム を 実行す る ことができます. 

LINK を 使用す るた めに， 1 つまた それ以上の 才 ブジェク ト ファイル を 作成し， つぎに これら 
の ファイル をす ベての 必要と される ライブ ライ リ ファイルと 一緒に 指定し， 処理の ため リ ンク 
しなければ なり ません. 

LINK はォ ブジェク ト ファイル 内の コードお よび データ を 結合し， 指定され た ライ ブラ リを 
探索し， ルーチン および 変数に 対する 外部 参照 を 解決し ます. 

つぎに， LINK は， リ ロケータ ブル （再配置 可能） な 実行 イメージ および， リロ ケ一ト （再 配 
St) 情報 を， 実行可能 ファイルに コピーし ます. 

MS-DOS は， LINK が 生成した リロ ケー ト 情報 を 使用して， 任意の 都合の よい メモリ ァ ドレ 
ス に 実行可能 ィ メージ を ロード し 実行し ま す. 

LINK は， 最高 1 メガバイトまでの コードお よび データが 入って いる プログラム を， 処理す 
る ことができます. 

本章で は， 実行可能な プログラム を 作成す るた めの LINK の 使用方法が 説明 されて います. 
ここで は， リンク 処理 を 制御す るた めに LINK コマンド 行中で 使用可能な スィッチ も， 定義 さ 
れ ています. このな のお 後の セクション では， LINK が プログラム を 作成す る 方法に ついて 説 
明して います. 
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2.2 LINK の 起動と 使用方法 



ログ ラム を 作成す るた めに LINK を 起動し， 使用す る 方法 を 説明して 
います. 3 つの 異なった 方法に よって， すなわち， MS-DOS コマンド 行 を 通して， プロンプト 
に 応答して， または 応答 ファイル を 使用して， LINK を 使用す る ことができます. 

いったん LINK が 開始され ると， LINK は， ユーザー か 指定した ファイル を 処理す るか， ま 
たは 他の ファイルの 入力 を 促します .[^110+ 回 キー を 押す ことによって， いつでも LINK を 
中止す る ことができます. 



2.2.1 コ マン ドラ インに よる 方法 

および その後に 処理したい ファイルの 名前 を タイプす る ことによって， 実行可能 プ 
ログ ラム を 作成す る ことができます. この コマンドの 害 式 は， つぎのように 指定され ます. 

LINK [く スィッチ〉 •••] く オブジェクト ファイル 名〉 •••， [く 出力 ファイル 名〉], 
[く マップ ファイル 名〉], [く ライブラリ ファイル 名〉 •••] i 

く スィッチ〉 は， LINK の 動作 を 制御す る もので， 必要に応じて 指定し ます. 

く オブジェクト ファイル 名〉 は， 一緒に リンクしたい オブジェクト ファイルの 名前です. こ 
れ らのフ アイ ルは， MASM または 高水準 言語の コンパ ィ ラ を 使用して， 作成され なければ な り 
ません. この ファイル 名 は 省略す る こと はでき ません. 

く 出力 ファイル 名〉 は， 作成したい 実行可能 ファイルの 名前です. 出力 ファイル 名の 指定 を 
ft 略す ると， LINK は， 最初の オブジェクト ファイル 名の 拡張 子 を、、. EXE 〃に 変えた ファイル 
名 を 自動的に 作成し ます. 

く マップ ファイル 名〉 は， マップ リスティング を 受け取る ファイルの 名前です. ファイルの 
名前が 指定され ず， ノ MAP, ZLINENUMBERS スィッチ も 指定され ない 場合， マップ ファ 
ィルは 作成され ません. 

く ライブラリ ファイル 名〉 は. プログラムに リンクしたい ルーチン 群の はいって いる ライブ 
ラリの 名前です. ライブラリ 名 を 指定し ない 場合 は， セミコロン （：） を タイプして ください. 
特定の フ アイ ル 名が 指定 されな レ ゝ 場合で も， その ファイル 名 を 区切る カンマ は 必要です. 
複数の オブジェクト ファイル 名， ライ ブラ イリ ファイル 名 を 指定 するとき は， これらの 名前 
を スペース （空白） または プラス 記号 （+ ) で 区切りながら 並べます. 

スィ ツチ は， コマンド 行 上の どこに でも 入れる ことができます. 

LINK では， コマンド 行中に 最低 1 つの オブジェクト ファイル 名が 必要です. 出力 ファイル 
名が 指定され ない 場合， LINK は， この 行中で 検出した 先頭の オブジェクト ファイルの フ アイ 
ル名を 使用し， これに、、 .EXE 〃という ファイル 名 拡張 子 を 付加す る ことによって， 省略時の 出 
力 ファイル 名 を 作成し ます. 
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拡張 子が 指定され なかった 場合， LINK は これらの ファイルの ための 省略時の ファイル 拡張 
子 を 使用し ます. LINK は， ォブジ ヱクト ファイルに 対してた OBJ" を， 実行可能 ファイルに 
対して た EXE" を マップ ファイル に対して 、、.MAP ウ を， また ライブラリ ファイル に対して や. 
LIB" を 使用し ます. 

例： 

LINK file.obj, file.exe， file, map, file, lib 

この 例で は， 、、file.obr という オブジェクト ファイル を 使用して， 、、file . exe 々という 実行 可 
能 ファイルが 作成され ます. LINK は， この プログラム 中で 使用され ている ルーチン および 変 
数の ための、、 file.lib" という ライブラリ を 探索し ます. LINK は， プログラム 中の セグメント 
お よび グループの リストが 入って いる 、、file . map" という 名前の マップ ファイル を 作成 します. 

LINK startup + file.file.file,; レ 

この 例で は、、 startup, obf および、、 file.obj" という 2 つの オブジェ ク ト ファイルから， 、、file. 
exe" という 名前の 実行可能 ファイルが 作成され ます. LINK は マップ ファイル を 作成し ます 
が， どの ライブラリ も 探索し ません. 

LINK moda + modb+modc+s ね rtupZPAUSE,, abc/MAP, ¥lib¥math 

この 例で は 、、！ noda.obf, 、、modb.obj"， 、、modc . obj" および 、、startup • obj" という 4 つの 
ォブ ジヱク トモ ジュールが リ ンク され， この プログラム 中で 使用され ている ルーチン および 
データの ための 、、math.lib" という ライブラリ ファイル （¥lib ディ レク ト リ内） が 探索され ま 
す • 次に， Amoda.exe" という 名前の 実行可能 ファイル および Aabc.map" という 名前の マツ 
プ ファイル が 作成 されます. なお ノ PAUSE スィッチ が 指定 されて いるので LINK は 実行 可 
能 ファイル を 作成す る 前に 休止し ます. 

2.2.2 コ マン ド プロンプト による 方法 

リンカの コマンド 名 CLINIC のみ を タイプす ると， LINK は 必要な 情報の 入力 を 求め る コマ 
ンド プロンプト を 表示し ます. この 方法の 手順 は， つぎのようになります. 
1. つぎのように タイプし， リターン キー を 押します. 

* LINK 

LINK は， つぎの コマンド プロンプト によって， ユーザーが リンクしたい オブジェクト 
ファイルの 入力 を 求めます. 

Object Modules [.OBJ]: 
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2. リンクしたい オブジェクト ファイルの 名前 を， タイプし ます. ファイル 名 拡張 子が 指定 
されなかった 場合， LINK は 省略時 処理で 、、.OBJ" を 使用し ます. 

複数の 名前 を 指定す る 場合 は， スペース （空白） または プラス 記号 （+ ) で 区切りな が 
ら 並べます. . に' 

指定す る 名前が 1 行 上に 入り切れない 場合， その 行の 最後に プラス 記号 （+ ) を タイプ 
して リターン キー を 押します. LINK は， 他の オブジェクト ファイルの 入力 を 促す コマ 
ンド ブロン ブト を 表示し ます. 

すべての オブジェ ク ト ファイル 名 を 指定したら， リターン キー を 押します. LINK は， 
つぎの 出力 ファイル 名の 指定 を 求める， 第 2 の コマンド プロンプト を 表示し ます. 

Run File [filename. EXE]: パ 

3. 作成したい 実行可能 ファイルの 名前 を タイプし， リターン キー を 押します. 拡張 子が 指 
定 されなかった 場合， LINK は 省略時 処理で、、. EXE" を 使用し ます. 省略時の 実行可能 

ファイル 名 を 使用したい 場合 は， 単に リターン キー を 押す. この ファイル 名 は 先頭の 才 
ブジ ヱクト ファイルと 同一です 力 、•， この ファイルの 拡張 子 は ".EXE な になります. 

リターン キーが 押される と， LINK は， リスト マップ ファイル 名の 入力 を 求める， 第 
3 のコ マン ド プロンプト を 表示し ます. 

List File [NUL.MAP]: 

4. 作成したい リスト マップ ファイルの 名前 を タイプして リターン キー を 押します. フ アイ 
ル名 拡張 子が 指定され ない 場合， LINK は 省略時 処理で、、. MAP" を 使用し ます. マップ 
ファイル を 希望し ない 場合 は， ファイル 名 を タイプせ ずに， リターン キー を 押します. 

リターン キーが 押される と， LINK は， リンク 処理に 用いる ライブラリ ファイル 名の 
入力 を 求める 最後の コマンド プロンプト を 表示し ます. 

Libraries [- LIB]: 

5. 参照され ている が， プログラムで 定義され ていない ルーチン または 変数が 入って いるす 
ベての ライブラリの 名前 を タイプし ます. 

複数の ライブラリ ファイル 名 を 指定す る 場合 は， これらの 名前 を スペース （空白） ま 
たは プラス 記号 （+ ) で 区切りながら タイプし ます. フ アイ ル名 拡張 子が 指定 さ れな か つ 
た 場合， LINK は 省略時 解釈で、、. LIB" を 使用し ます. 指定す る 名前が 1 行 上に 入り 切 
ら ない 場合 は， この 行の 最後に プラス 記号 （+ ) を タイプして， リターン キー を 押し ま 
す. LINK はさら に 他の ファイル 名の 入力 を 求めます. 
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すべての 名前 を 入力した 後， リターン キー を 押します. 

どの ライブラリ も 検索し ない 場合 は， 単に リターン キー を 押します. 

最後の コマンド プロンプト に対する 入力が 済む と， LINK は， ただちに 処理 を 開始し ます. 
注意 

ファイルが 他の ディ レク 卜 リ内 または 他の ディスク 上に ある 場合 は， パス 名 や ドライブ 名 を 

含めた 正しい ファイル 名 を 指定し ます. LINK は， 才ブジ ヱクト ファイル を 見つける ことが で 
きない 場合， メ ッ セージ を 表示し， 必要なら ディ ス ク を 変更で き るよう に 待ち 状態に な ります. 
入力 行の 終わ りに スィッチ を 付加す る ことができ ま す. 

任意の プロンプトの 後に セ ミ コロン （；） を タイプす る ことによって， それ 以降の すべての ブ 
ロン ブトに おいて 省略時の 処理 を 選択す るよう に， LINK に 命令す る ことができます. LINK 
は セミコロン を 検出す ると 初期設定に 従った 処理 を 行い 実行可能 ファイル を 作成し ます. 



例: 



コマンド プロンプト を 利用した 入力 例 をつ ぎに 示します. 



LINK 



Object Modules [. OBJ]: moda + modb + 
Object Modules [. OBJ]: mode + startup/PAUSE 
Run File [moda. EXE]: 
List File [NUL. MAP] : abc 
Libraries [• LIB]: ¥lib¥math 

こ の 例で は 、、moda • obf, 、、modb • obf, 、、！ node • obf お よ び "startup . obj" という ォ ブジ ェ 
ク トモ ジュールが リ ンク され， プログラム 中で 使用され ている ルーチン および データの ために 
^nath . lib" (¥lib ディレクトリ 内） という ライブラリ ファイル が 検索 されます. 次に 
"moda .exe" という 名前の 実行可能 フ ァ ィ ルぉ よ び 、、abc • map" と い う 名前の マ ップフ アイ ル 
が 作成され ます. 才 ブジェク 

ことによって， 実行可能 ファイル を 作成す る 前に， LINK が 休止し ます • 
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2.2.3 応答 ファイル による 方法 

応答 ファイル 内に， 処理に 関係した すべての ファイルの 名前 を リストす る ことによって， ま 

た LINK コマンド 行 上で この 応答 ファイルの 名前 を 指定す る ことによって， プログラム を 作成 
する ことができます. この コマンド 行 は， つぎのように 指定され ます • 。 

LINK @< 応答 ファイル 名〉 

く 応答 ファイル 名〉 は， LINK が 使用す る ファイル 名 を 収めた 応答 ファイル 名です. 応答 ファ 
ィル名 を 用いる とき は， この 前に アット マーク （@) が 置かれなければ なりません. この ファ 
ィルが 他の ディ レク ト リ内 または 他の ディスク ドライブ 上に ある 場合， これに パス 名 または ド 
ライブ 名な がつ けられなければ なりません. 

応答 ファイルに は， 好きな ファイルの 名前 をつ ける ことができます. ファイルの 内容 は， つ 
ぎの よう な 形式で 構成 されて います. 

く才 ブジェク 卜 ファイル 名〉 
[く 出力 ファイル 名〉] 
[く マップ ファイル 名〉] 
[く ライブラリ ファイル 名〉] 

各 グループの ファイル 名 は， 別々 の 行 上で 指定され なければ なりません. 応答 ファイル 名の 
各行が， 前項で 解説した コマンド プロンプト に対する 入力に 対応して います. 指定す る 名前が 
1 行に 入り 切らない 場合 は， その 行の 最後に プラス 記号 （+ ) を タイプす る ことによって， 次の 
行に 継続す る ことができます. ある グループ に対して ファイル 名 を 指定し ない 場合 は， その 行 
を 空に してお かなければ なりません. スィッチ は， どの 行で も 指定 可能です. 

応答 ファイル 内の どの 行 上で も， セミコロン （；） を 入れる ことができます. LINK は， セミ 
コロン を 検出す る と 応答 ファイル 内で また 指定され ていない すべての ファイル に対して， 省略 
時の フ アイ ル名を 自動的に 使用し， ファイルの 残りの 部分 は 無視され ます. 

応答 ファイル を 使用して リンク 処理 を 行う とき， LINK は， 画面 上に 応答 ファイルからの 各 
応答 を 表示し 処理 を 進めます. 応答 ファイルに， 必要な ファイル 名前が 入って いない 場合， 
LINK は 不足して いる ファイル 名の 入力 を 求める コマンド プロンプト を 表示し， 応答が キ一 
ボードから 入力され るまで 待ち 状態になります. 

例： 

moda modb mode startup 

/PAUSE . 
abc 

¥lib¥math 
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この 応答 ファイル は， や moda", 、、modb", "mode" および、、 s は rtup" という 4 つの オブジェ 
ク トモ ジュール を リンクす るよう に， LINK に 指示す る ものです. LINK は， や moda.exe" と 
いう 実行可能 ファイル を 作成す る 前に， ユーザーが ディスク を 交換で きる ように， 休止し ます. 
LINK は， や abc. map" という マップ ファイル も 作成し， 、、¥lib¥math . lib" という ライブラリ 
を 検索し ます. 

2.2.4 ライ ブラ リファイ ルの 検索/ \° ス の股定 

コマンド 内で， ライ ブラ リ 名と 一緒に 1 つまた は それ以上の 検索 パス を 指定す る ことによ つ 
て， あるいは LINK を 呼び出す 前に 環境 変数 や LIB" に 検索 パス を 割り当てる ことによって， 
これらの ライブラリ を 見つける ために ディ レク ト リ および ディスク ドライブ を 検索す るよう に 
LINK に 命令す る こ とがで きます. 

検索 パスと は， ディレクトリ または ドライブ 名の 単なる パス 指定の ことです. 検索 バス は， 
LINK コマンド 行 上で ライブラリ 名と一 緒に， または ^Libraries" コマンド プロンプトに 応答 
して， 入力され ます. 最高 16 ま での 検索 パス を 指定す る ことができます. ま た， MS-DOS の SET 
コマンド を 使用して， 検索 パス を LIB 変数に 割り当てる こと もで きます. この場合， 検索 パス 
は セミコロン （；） によって 区切られなければ なりません. 

検索 パス は， ライブラリ に 明示の パス 指定 または ドライブ 名がない 場合の み 使用され ます. 
LINK は， 最初に， カレント ディレクトリ を， 次に， この コマンドで 指定され た 各々 の ディ レ 
ク トリお よび ディスク ドライ ブを， 最後に， LIB 変数で 指定 された ディレクトリ および ディ ス 
ク ドライブ を 検索し ます. LINK は 指定され た 名前の ライブラリ を 検出す るまで， または 検索 
すべき 場所が なくなる まで， 検索 を統 行し ます. 

ディレクトリ および ディスク ドライブ は， 検索 パスが コマンド 中で 指定され た 順に， または 
LIB に 割り当てられた 順に 検索され ます. ライブラリ 名に 対して， パス 指定 または ドライブ 名 
が 指定され ている 場合， LINK は 指定され た ディ レク ト リ または ディスク ドライブ にある ライ 
ブラ リ のみ を 検索し ます. 

例： 

LINK file, , file, map, A : ¥altlib¥math . lib + common + B: + D : ¥lib¥ 

この 例で は， LINK は， や math. lib" という ライブラリ を 見つける ために， ドライブ A 上の 
^altlib" ディ レク 卜 リ のみ を 検索し まずが， 、、common . lib" を 見つける ために， ドライブ A 
上の カレント ディ レクト リ， ドライブ B 上の カレント ディ レク ト リ， および 最後に ドライブ D 
上の "¥lib" という ディレクトリ を 検索し ます. 
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SET LIB = C:¥lib; U : ¥system¥lib 
LINK file, , file, map, math + common 

この 例で は， LINK は， 、、math.lib" および 、ommon.lib" という ライブラリ を 見つける た 
めに， カレント ディレクトリ， ドライブ C 上の 、、¥lib" という ディレクトリ， および ドライブ 
U 上の 、、¥svstem¥lib" という ディレクトリ を 検索し ます. 

2.2.5 マップ ファイル 

マップ ファイルに は， プログラム 中の すべての セグメントの 名前， ロード アドレス， および 
長さが リ ストされ ます. この ファイルに は， この プログラム 中の すべての グループの 名前と ロー 
ドア ドレス プログラム 開始 ァ ドレス， および 検出され る 可能性の あるす ベての エラーに ついて 
の メッセージ も リスト されます. 

LINK コマンド 行で ZMAP スィッチが 指定され た 場合， この マップ ファイルに は， すべて 
の パブ リ ック シンボルの 名前お よび ロード アドレスが リ ス ト されます. 

セグメ ン ト 情報 はつぎの よ う な 形式で 出力され ます. 

Start Stop Length Name Clase 
00000H 0172CH 0172DH TEXT CODE 

01730H 01E19H 006EAH DATA DATA に 

、、Start" および や stop" の 項に は， 各 セグメント の 先頭お よ び琺終 バイ 卜の 20 ビット ァ ドレ 
ス （16 進） が 示されます. これらの アドレス は， アドレス 0000 H と 想定され る ロード モジ ユー 
ルの 開始 点からの 相対 アドレスです. オペレーティングシステム は， この プログラムが 実際に 
ロード される とき， それ 自身の 開始 アドレス を 設定し ます. 、、Length" の 項に は， セグメントの 
長さが バイト 単位で、、 Name" の 項に は， セグメントの 名前が， で lass" の 項に は セグメントの 
クラス 名が 示されます. 

グループ 情報 は， つぎの ような 形式で 出力され ます. 

Origin Group 
0000:0 IGROUP 
0173:0 DGROUP 

.' この 例で は， IGROUP は コード （命令） グループの 名前， DGROUP は データ グループの 名 
前です • 
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リス ティ ング ファイルの 終わりに， LINK は プログラムの ェン ト リポィ ン 卜の アドレス を 示 
します • 

LINK コマンド 行で Z MAP スィ ツチが 指定され た 場合， LINK は パブ リ ック シンボル リス 
トを マップ ファイルに 付加し ます • これらの シンボル は， 2 回， すなわち 1 回目 は アルファべ ッ 
ト顯 に， 次の ロード アドレス 順に 示されます • この リスト は， つぎの ような 形式で 出力され ま 
す. 



ADDRESS 
0000:1567 
0000:1696 
0000: 01 DB 

0000: 131 C 
0173:0035 



PUBLICS BY NAME 



brk 

chmod 
chkstk 
clea rerr 



ADRESS 
0000: 01 DB 
0000: 131C 
0000:1567 
0000:1696 
0000 : 0035 

パブ リ ック シンボルの 

は， シンボルの， ロード モジュールの 開始 点からの 相対 位置 を 示して います • この モジュール 
の 開始 点 は， アドレス 0000:0000 にある と 想定され ます. 

/ HIGH お よ び/ DSALLOCATE ス ィ ツチが 指定 され， この プログラムの コードお よび 
データ をリ ンク した ものが 64K バイ ト 以下で あるとき， マップ ファイルに は， 通常 大きな セグ 
メント アドレス を 持つ シンボル を 示す ことができます. これらの アドレス は， シンボルが， プ 
ログ ラム コードお よび データの 実際の 開始 点よ り 低い 位置に ある こと を 示して います. たとえ 
ば， つぎの シンボル エントリ では， lemplat ビ はこの プログラムの 開始 点より 低い 位置に ある 
ことが 示されて います. 

FFF0 ： 0A20 template 
template の 20 ビット アドレス は， 00920H である ことに 注意して ください. 



PUBLICS BY VALUE 

chkstk 
clea rerr 
brk 

chmod 



レス は， セグメント： オフ セッ ト という 形式で 示されます. これら 
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2.2.6 



. 丁 MP 



LINK は， 通常， リンク 処理の ために 使用可能な メモリ を 使用し ます. LINK は， 使用可能 
な メモリ を 使い尽く した 場合， カレント ディ レクト リ 内に という 名前の 一時 ディ 
スク ファイル を 作成し ます. LINK は， この ファイル を 作成した とき， つぎの メッセージ を 表 
示します. 

. TMP has been created. 



Do not change diskette in drive, <d:> 

この メッセージが 出力され た 後 は， リンク 処理が 終了す るまで， この ドライブから ディスク 
を 取り外し てはいけ ません. LINK は， 実行可能 ファイル を 作成した 後， 一時 ファイル を 自動 
的に 削除し ます. 

警告 

ユーザー 自身の ファイル のために， VM. TMP という ファイル 名 を 使用して はなり ません. 
LINK がー 時 ファイル を 作成した とき， 以前に 同一の 名前が 付けられて いるすべ ての ファイル 
を 破壊し ます. 



2.3 LINK の スィッチ 

リンカ スィッチ によって， LINK によって 実行され る タスクが 指定され， 制御され ます. す 

ベての スィッチ は， リンカ スィッチ 文字で ある. スラッシュ （Z) で 開始し ます. スィッチ は， 
LINK コマンド 行 上の どこに でも， 指定 可能です. 

LINK に はつぎの ような スィ ツチが あります. ，- 



/PAUSE 

/MAP 

/STACK 

/CPARMAXALLOC 
/HIGH 

/DSALLOCATE 
/OVERLAYINTERRUPT 
/LINENUMBERS 
/NOIGNORECASE 

/NOGROUPASSOCIATION 
/NODEFAULTLIBRARYSEARCH 

/SEGMENTS 
/DOSSEG 



リンク 中に 休止 

パブ リ ック シンボル マップの 作成 

スタック サイ ズの 設定 

最大 割り当て スペースの 設定 k . 

上位 開始 アドレスの 設定 
データ グループの 割り当て 

オーバ— レイ 割り込みの 設定 

行 番号の 表示 
大文字 小文字の 区別 
グループ を 取り除く 
省略時の ライ ブラ リ を 無視す る 
最大 セグメントの 設定 

DOS の セグメント 配列の 利用 
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2.3 LINK の スィッチ 



2.3.1 リンク 中に 休止す る 
I 書 式 I /PAUSE 




化 



/P 

/ PAUSE スィッチが 指定され た 場合， LI N K は 実行可能 ファイル を ディスクに 害き 込む 前 
に 休止し ます， この スィッチ によって， LINK が 実行可能 し EXE) ファイル を 出力す る 前に， 
ユーザー は ディスク を 交換す る ことができます. 

Z PAUSE スィッチが 指定され た 場合， LINK は， 実行 ファイル を 作成す る 前につ ぎの メッ 
セージ を 表示し ます. 

About to generate . EXE file 

Change diskette in drive <d:> and press <ENTER> 

LINK は， リターン キーが 押される と， 処理 を 再開し ます. / PAUSE スィッチが 指定され な 
かった とき， LINK は リンク 処理 を 最初から 終わりまで， 停止し ないで 実行し ます. 

注意 

VM.TMP ファイルが 作成され ている 場合， この ファイル のために 使用され ている ディスク 
を 取り外して はなり ません. 

き 
例： 



LINK file.obj/PAUSE, file, ex も 画 ¥lib¥math. lib 



この コマンド によって， LINK は， 、、file.exe" という 実行可能 ファイル を 作成す る 直前に， 
休止し ます. 実行可能 ファイルが 作成され た 後， MASM は， ユーザーが もとの ディスク を 戻す 
ことができる ように， 再び 休止し ます. 



2.3.2 パブリック シンボル マップの 作成 



害 式"] /MAP 



ノ M 



/MAP スィッチが 指定され た 場合， LINK は， プログラムで 宣言され たす ベての パブ リツ 
ク シンボルの リスティング を 作成し ます. この リスト は， LINK によって 作成され た マップ 
ファイルに コピー されます. リス ティ ング ファイルの 書式に ついての 詳細 は， 2,2.5 の、、 マップ 
ファイル〃 を 参照して ください， 
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注意 

LINK コマンドで マップ ファイル を 指定し なかった 場合， 、、List file" プロンプトで， または 
くの プロンプトの 前に， ノ MAP スィッチ を 入力す る ことによって， LINK に マップ ファイル 
を 作成され る ことができます. LINK は， 作成され た マップ ファイル にこの コマンド 中で 指定 
された 先頭の 才ブ ジヱク ト ファイルと 同一の ファイル 名， および ".MAP ゥ という 省略時の 拡 
張子 をつ けます. 



例 



LINK file . obj, file • exe， file . map/MAP, ； 

この コマンド は， 、、file.obf という ファイル 内の すべての 共有 記号の マップ を 作成し ます, 



2.3.3 スタックの 大きさの セッ 卜 
I 害 式 I /STACK ： く サイズ〉 



/ STACK スィッチが 指定され た 場合， プログラムの スタックが 〈サイズ〉 によって 指定 さ 
れた バイ 卜 数に セッ ト されます. サイズ は， 1〜65535 の 範囲 内に ある 任意の 正の 整数 値が 可能 
です. この 値 は， 10 進， 8 進， または 16 進数が 可能です. 8 進数 は ゼロで， 16 進数 は ゃ0ビ で 
始められなければ なりません. 

LINK は， 通常， プログラムの スタックの 大きさ を オブジェクト ファイルで 示されて いるす 
ベての スタック セグメントの 大きさに 基づいて 自動的に 計算し ます. ノ STACK が 指定され た 
場合， LINK は 値 を 計算す る 代わりに， 指定され た サイズ を 使用し ます. 

この プログラム 中に スタック セグメ ントが 存在し ない 場合. LINK は エラー メ ッ セージ を 表 
示します. この メッセージが 出力され ないように する ために， すべての プログラム において 最 
低 1 つの スタ ック セグメント を 定義し なければ な り ません. 

例： 



LINK file. obj/STACK: 512, file.exe,,; 
この 例で は， スタックの 大きさ は 512 バイ 卜に セッ 卜されます， 

LINK moda + modb, run/ST ： QxFF t ab. map^VlibVstart ； 
この 例で は， スタックの 大きさ は 255 (FFH) バイトに セット されます • _ 

LINK startup+file/STiOSatile, 
この 例で は， スタックの 大きさ は 24 (8 進の 30) バイトに セット されます, 
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2.3 LINK の スィッチ 



2.3.4 最大 割り当て スペースの セット 
I 書 式 I /CPARMAXALLOC ： く サイズ〉 

I 省略 形 I /0 

, CPARMAXALLOC スィッチ を 指定す る ことによって， プログラムが メモリ 中に ロード 
された とき， この プログラムが 必要な， 最大の 16 バイトの パラグラフ 数が セット されます. こ 
の 数 は， プログラム を ロードす る 前に この プログラム のために スペース を 振り当てる とき， 才 
ペレ 一 ティング システム によって 使用され ます. 

く サイズ〉 は， 1〜65535 の 範囲 内に ある 任意の 整数 値が 可能です. これ は， 10 進， 8 進， ま 
たは 16 進数で なければ なりません. 8 進数 は ゼロで， 16 進 値 は^ で 始められなければ^ り 
ません， 

LINK は， 通常， 最大の パラグラフ 数 を 65535 に セットし ます. これ はすべ ての メモリ を 表 
わして いるので， オペレーティングシステム は 常に この 要求 を 拒否し， 存在す る 最大の 連続し 
た ブロックの メモリ を 割り当てます. ZCPAMAXALLOC スィッチが 指定され た 場合， オペ 
レー ティング システム はこの スィッチで 指定され た 量の スペース を 割り当てます. これ は， メ 
モリ 中の 他の スペース を 他の プログラムが 使用で きる こと を 意味し ます. 

く サイズ〉 力；， プログラム によって 必要と される 最小の パラグラフ 数より 小さい 場合， LINK 
は ユーザーの 要求 を 無視し， 最大の 値が 必要と される 最小の パラ グラ フ 数と 等しく なる よ う に 

セットし ます. プログラム によって 必要と される 最小の パラグラフ 数 は， 常に この プログラム 
中の コードお よ びデー タの パラグラフ 数 以上に なります. 

例： - , 

LINK file.obj/C: 15, file, ex も，； 
この 例で は， 最大の 割り当て は 15 パラグラフに セット されます. 

LINK moda + modb, run/CPARMAXALLOC : Oxff, ab. map,; 
この 例で は， 最大の 割り当て は 255 (FFH) パラグラフに セット されます. 

LINK startup -h file/C: 030,,; 
この 例で は， 最大の 振 当て は 24 (8 進の 30) パラグラフに セット されます. 
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2.3.5 上位 開始 アドレスの セット 

I 害 式 I /HIGH 1 
[^略 形 1 /H 

/HIGH スィ ツチが 指定され た 場合， プログラムの 開始 アドレスが 使用可能な メモリの 中の 
できるだけ 高い アドレスに セット されます. この スィッチ によって， LINK は， オペ レー ティ 
ング システム にこの プログラム を できるだけ 高い ァ ドレスに ロー ド させる 情報 を， 実行可能 

ファイルに 付加し ます. 

/ HIGH が 指定され ない 場合， プログラムの 開始 ァ ドレス は メモ リ 中の できるだけ 低い ァ ド 
レスに セッ ト されます. 

例： 

LINK startup + file/HIGH, file, file, ； • 

この 例で は， 、、file.exe" 内の プログラムの 開始 アドレスが， 使用可能な メモリ 中ので きる だ 
け 高い ァ ドレスに セッ ト されます. 

2.3.6 データ グループの 割り当て 
I 書 式 I /DSALLOCATE 

I 省略 形 I /0 

Z DSALLOCATE スィ ツチが 指定され た 場合， 、、DGROUP" という 名前の グループに 厲 する 
項目に ァ ドレス を 割り当て ると き， 通常の 処理 を 逆にす るよ う に LINK に 命令し ます. 通常， 
LINK は， グループ 内の 最下位 パイ トに オフセット 0000H を 割り当てます 力 5 , / DSAL- 
LOCATE が 指定され た 場合， LINK は， この グループ 内の 最上 位 パイ トに オフ セッ ト FFFFH 
を 割り当てます. この結果， 出力され た データが， DGROUP が 入って いる メモリ セグメント 中 
の できるだけ 高い ァ ドレスに ロード されます. 

/ DSALLOCATE スィ ツチ は， プログラムの 開始 点よ り 低い ァ ドレスの 未使用の メモリ を 
利用す るた めに， 通常 ZHIGH スィッチと いっしょに 使用され ます. LINK は， DGROUP 内 
のす ベての 使用可能な バイ トは， この プログラムより 低い 隣接した アドレスの メモリ を 占有し 
ている と 想定し ます. この グループ を 使用す るた めに， セグメント レジスタ は DGROUP の 開 
始 アドレスに セッ 卜されなければ なりません. 




18 



2.3 LINK のスィ ツチ 



例： ぐ ふ〜 卜文 屮 字文ズ - c 

LINK startup + file/HIGH/DSALLOCATE, file, file,; 

この 例で は， この プログラム を メモリ 中の できるだけ 高い アドレスに ロードし， つぎに 
DGROUP 内の すべての データ 項目が この グループ 内の できるだけ 高い ァ ドレスに ロードされ 
るよう に これらの 項目の オフ セッ トを 調整す る こと を， LINK に 命令し ます. 

2.3.7 行 番号の 表示 

| 害 式 I /LINENUMBERS 

/ LINENUMBERS スィッチ が 指定 さ れた 場合， 各 プログラム ソース 行の 開始 アドレス を 
リストす るよう に， LINK に 命令し ます. この 開始 アドレス は， 実際に は， 対応す る ソース 行 
を 構成して いる 命令 群の ァ ドレスです. LINK は， この 情報 を マップ ファイルに コピーし ます. 
ユーザー は プログラムの デバッギング のために， この ファイル 内の 情報 を 使用す る ことができ 
ます. 

LINK は， LINK コマンド 行中での マップ ファイル 名が 指定され た 場合の み， また 指定され 
た オブジェクト ファイルに 行 番号の 情報が ある 場合の み， 行 番号の 番号 付け を 行います. 行番 
号の 番号 付け は， 高水準 言語の コンパイラに おいての み， 使用可能です. オブジェクト フ アイ 
ルに行 番号 情報がない 場合， LINK は/ LINEMUMBERS スィ ツチ を 無視し ます. 

注意 

LINK コマンド 中に マップ ファイル を 指定し なかった 場合， "List file "プロンプトで， また 
はこの プロンプトの 前に// LINENUMBERS スィッチ を 入力す る ことによって， LINK に 
マップ ファイル を 作成させる ことができます. LINK は， 作成され た マップ ファイルに， この 
コマンド 中で 指定され た 先頭の オブジェ ク ト ファイルと 同一の ファイル 名， および \ MAP" 
という ^略 時の 拡張 子 をつ けます. 

例： 

LINK file.obj/LINENUMBERS, file.exe, file, map,; 

この 例で は， や file, obj" という オブジェクト ファイル 内の 行 番号 情報が， 、、f ile . map" という 
マップ ファイル 内に コピー されます. 
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2.3.8 大文字 小文字の 区別 
/NOIGNORECASE 

I 省略 形 I /NOI 

Z NOIGNORECASE スィ ツチが 指定され た 場合， シンボル 名に おける 大文字と 小文字 を 区 
別して 扱うよう に， LINK に 命令し ます. 通常， LINK は 大文字と 小文字 を 同一の ものと 見な 
し， 、、TW(T, 、、two" お よ び、、 Two" という 名前 を 同一の シ ン ボルと して 扱い ま す. / NOIGNOR- 
ECARE" を 指定す る ことによって， LINK は これらの 名前 を一 意な 記号と して 扱います. - 

ZNOIGNORECARE スィッチ は， 通常， 高級 言語の コンパイラ によって 作成され たォブ 
ジ ェクト ファイルと 一緒に 使用され ます. コンパイラの 中には， 大文字と 小文字 を 区別の ある 
英字と して 扱い， LINK もそう であると 想定す る もの もあります. 



例: 



LINK file.obj/NOI, file, exe.file. map, ¥lib¥slibc. lib; 



この コマンド によって， LINK は 記号 名に おける 大文字と 小文字 を 区別の ある 英字と して 扱 

います. 、、file.obj" という オブジェクト ファイル は， 、、¥lib¥slibc.lib" という 標準 C 言語 ライ 
ブラ リ 内の ルーチン 群と リンク されます. C 言語 は， 大文字と 小文字が 別々 に 扱われる こと を 期 
待して います. 

2.3.9 省略時の ライブラリ を 無視す る 

L 書 式 J /NODEFAULTLIBRARYSEARCH ケ 




/NOD 



. -,〜 



/ NODEFAULTLIBRARYSEARCH スィ ツチが 指定され た 場合， オブジェ ク ト ファイル 
内で 検出され る 可能性の あるす ベての ライブラリ 名 を 無視す るよう に， LINK に 命令し ます. 
高級 言瑭の コンパイラ は， 省略時の 一群の ライブラリ が 確実 にこの プログラムに リンク される 
ように， ライブラリ 名 を オブジェクト フ アイ ルに 付加す る ことができます. この スィッチ によつ 
て， これらの 省略時の ライブラリが 無効に なり， LINK コマンド 行 上に， 希望す る ライブラリ 
を 明示で 指定す る ことができます. 



例: 



LINK startup + f ile/NOD, file.exe, ,¥lib¥math. lib 



こ の 例で， "startup • obf および lile • obj" という オブジェクト フ アイ ルが， 、、¥lib¥math . 
lib" という ライブラリの ルーチン 群に リンク されます. startup, obj または file, obj 内で 指定 
されて いた 可能性の ある， すべての 省略時の ライ ブラ リ は 無視され ます， 
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2.3 LINK の スィッチ 



2.3.10 プログラムから グループ を 取り除く 
|_ 害 式 1 /NOGROUPASSOCIATION 



/NOG 



/ NOGROUPASSOCIATION スィッチ を 指定 し た 場合， デー タ および コード 項目に ァ ドレ 
スを 割り当てる とき， グループの 関連 を 無視す るよ う に LINK に 命令し ます. 

参考 

この スィッチの 使用 は， お勧めで きません. 



2.3.11 オーバーレイ 割り込みの セッ ト 
し 害 式 | /OVERLAYINTERRUPT: く 値〉 

1 省略 形 I /0 

Z OVERLAYINTERRUPT スィ ツチが 指定され た 場合， オーバーレイ 口一 ディ ン グルー チ 
ンの 割り込み 番号が 〈値〉 に セット されます. この スィッチ によって， 通常の オーバーレイ 割 
り 込み 番号 （03FH) が 無効になります. 

く 値〉 は， 0〜255 の 範囲 内の 任意の 整数 値が 可能です. これ は， 10 進， 8 進， または 16 進数 
でなければ なりません. 8 進数 は， 先行 ゼロで， 16 進数 は， 、、0x" で 始められなければ いけ ませ 
ん. 

注意 

棟 準 MS-DOS 割込みと 矛盾す る 割 り 込み 番号 を 使用す る こ と は， お勧めで き ません. 
例： 

LINK file.obj/0:255, file.exe, ,; 

この 例で は， オーバーレイ 割り込み 番号が 255 にセッ ト されます. 
• LINK moda + modb, run/OVERLAY ： Oxff, ab. map,; 

この 例で は， オーバーレイ 割込み 番号が 255 (FFH) に セット されます. 

LINK s ね rtup + file, file/0377, ，； 
この 例で は， オーバーレイ 割込みが 255 (8 進の 377) に セット されます. 
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2.3.12 最大の セグメント 数の セット 

I 害 式 I /SEGMENTS ： く サイズ〉 



/SEGMENTS ス ィ ツチが 指定され た 場合， プログラムの セ グメ ントの 数く サイズ〉 の 上限 
を LINK にわたします. LINK は， 指定され た 限界より 多く 検出した 場合， エラーメッセージ 
を 表示し 停止し ます. この スィッチ は， 省略の 限界で ある 128 の セグメント を 無効に する ため 
に 使用され ます. 

〈サイズ〉 は， 1〜1024 の 範囲 内の 任意の 整数 値が 可能です. これ は， 10 進， 8 進， または 16 
進数で なければ なりません. 8 進数 は 先行 ゼロで， 16 進数 は、、 Ox" で 始められなければ なり ま 
せん. 

/ SEGMENTS が 指定 さ れ なかった 場合， LINK は 最高 128 の セグメント を 処理す るのに 
充分な メモリ スペース を 割り当てます. この プログラムが 128 より 多くの セグメント によって 
構成され ている 場合， セグメ ントの 限界 をより 大きな 値に セッ ト する ことによって LINK が処 
理 可能な セグメ ント数 を 増加させます. 



例: 



LINK file.obj/SE:10, file, ex も ,; 



この 例で は， セグメントの 限界が 10 に セット されます. 

LINK moda + modb, run/SEGMENTS ： Oxff,ab . map, ； 
この 例で は， セグメントの 限界が 255 (FFH) に セット されます. 

LINK startup + file, file/SE ： 030, , ； 

この 例で は • セグメントの 限界が 24 (8 進の 30) に セット されます, 
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2.3.13 DOS の セグメント 配列 を 利用す る 
し 害 式」 /DOSSEG 



厂 省略 形 I ,0。 

/ DOSSEG が 指定され た 場合， LINK は， MS-DOS セグメント の 順序 付けの 規約に 従って， 



実行可能 ファイル 内の すべての セグメント を 配置し ます. この 規約 は， つぎの ような ものです. 



1. 



2. 



3. 



で ODE" という クラス 名が 付けられた すべての セグメ ン ト は， 実行可能 ファイルの 開始 
点に 匿 かれる. 

"DGROUP" という 名前の グループに 厲 さない すべての セグメント は， XX)DE" セグメ 
ントの 直後に 匿 かれる. 

VN DGROUP" に厲 する すべての セグメント は， この ファイルの 終わりに 匿 かれる. 



例： 



LINK startup + test/DOSSEG, file, math + common 



, LINK は， 、、file.exe" という 名前の 実行可能 ファイル を 作成し ます. 
この ファイル 内の セグメ ント は， MS-DOS セグメ ントの 順序 付けの 規約に 従って 配置され ま 
す. や start.obf と、、 test.obj ヶ という オブジェクト ファイル 内の セグメント， および A ma th. 
lib" と 、、common . lib" という ライブラリから コピーされ たす ベての セグメント は， 前述の 指 
定 された 順に 配置され ます. 
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2.4 LINK の 動作 方法 

LINK は， もとの ソースファイルで 示されて いる 命令に 従って， プログラムの コードと デー 
タ セグメント を 連結す る ことによって， 実行可能 ファイル を 作成し ます. これらの 連結され た 
セグメント は， や 実行可能 イメージ" を 形成し， これらの イメージ は， 実行の ために この プロ グ 
ラムが 呼び出された とき， メモリ 中に 直接 コピー されます. したがって， LINK が セグメント 
を 実行可能 ファイルに コピーす る 順序お よび 方法 は， これらの セグメ ントが メモリ 中に ロード 
される 順序お よ び 方法 を 定義 します. 

プログラムの セグメント を リンクす る 方法 を LINK に 命令す るた めに， SEGMENT ディ レ 
ク ティブ を 使用して セグメ ントの « 性 を 指定す るか， または プログラム 中で GROUP デレイ ク 
ティブ を 使用す る ことによって， セグメントの グループ を 形成し ます. これらの ディ レク ティ 
ブは， プログラム 中の すべての セグメ ン ト 順序に および 相対 開始 ァ ドレス を 定義す る グループ 
の閱 連， クラス， 位置 合わせ， および 結合 タイプ を 定義し ます. コマンド 行 スィッチ を 通して 
ユーザーが 指定した すべての 情報の 他に， この 情報が 有効です. 

本節で は， セグメント を 結合し， メモリ 中の 項目に 対する 参照 を 解決す るた めの 処理 方法 を 
説明し ます. 

2.4.1 セグメントの 位置 合わせ 

LINK は， セグメントの 位置 合わせの タイプ を 使用して， この セグメントの 開始 アドレス を 
セッ 卜します. 位置 合わせの タイプ は， BYTE, WORD, PARA, および PAGE です. これら 
は， バイ ト， ワード， パラグラフ， および ページの 境界に おける 開始 アドレスと 対応して おり， 
それぞれ， 1, 2， 16， および 1024 の 倍数の アドレス を 表わして います. 

LINK は， セグメント を 検出した とき， この セグメント を 実行可能 ファイルに コピーす る 前 
に， 位置 合わせの タイプ を チェック します. 位置 合わせが WORD, PARA, または PAGE で 
ある 場合， LINK は， 最後に コピーされ たバイトが 該当する 境界で 終了して いるか どうか 知る 

ために， 実行可能 イメージ を チェックし， そうでない 場合， この イメージ を 余分な ゼロ バイト 
で 埋めます. 

2.4.2 フレーム 番号 

LINK は， プログラム 中の 各 セグメント ごとに， 開始 アドレス を 計算し ます. この 開始 アド 
レス は， セグメントの 位 匿 合わせ， および 実行可能 ファイルに すでに コピー された セグメント 
の 大きさに 基づきます. この アドレス は， オフセットお よびや 棵準 フレーム 番号な によって 構 
成されます. 標準 フレーム 番号 は， 1 バイ ト または それ以上の バイ 卜の セグメ ン 卜が 入って いる 
メモリ 中の 先頭の パラグラフの アドレス を 指定し ます • フレーム 番号 は， 常に 16 の 倍数 (すな 
わち， パラグラフの アドレス） です. オフセット は， この パラグラフの 開始 点から セグメント 
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内の 先頭 バイ 卜までの バイ ト 数です. BYTE および WORD の 位置 合わせの 場合， オフセット 
は 非 ゼロの 場合が あります が， PARA および PAGE の 位置 合わせの 場合， 常に ゼロです. 

セグメント を リンク するとき， この セグメントの フレーム 番号 を LINK によって 作成され た 
マップ ファイルから 取得す る ことができます. フレーム 番号 は， この セグメント のために 指定 
さ れた 、、開始〃 アドレスの 16 進の 先頭の 5 桁です. 



2.4.3 セグメントの 順序 

LINK は， オブジェクト ファイル 内で セグメント を 検出した ときと 同じ 順序で， これらの セ 

グメ ントを 実行可能 ファイルに コピーし ます. この 順序 は， LINK が 同一の クラス 名が 付けら 

れた 複数の セグメント を 検出し ないかぎ り， この プログラム を 通して 維持され ます. 同一 のク 

ラス 名が 付けられた セグメ ントは 同一の クラスに 厲し， 連結した プロ ックと して 実行可能 ファ 
ィルに コピー されます. 

たとえば， 以下の プログラム 部分で は， "DATAX" および T>ATAZ ケ という セグメント は 
1 クラス を 形式し ます. 両方の セグメント は， 実行可能 ファイルで、、 TEXT な セグメントの 前に 
コピー されます. 



DATAX 
DATAX 

TEXT 
TEXT 

DATAZ 
DATAX 



segment 
ends 

segment 
ends 

^^， 零^^ ^ 

segment 
ends 



'DATA' 



'CODE' 



'DATA' 



すべての セグメント は， 何ら かの クラスに 厲 します. クラス 名が 明示で 定義され ていない セ 
グメ ントに は， 、、！ mil" クラス 名が 付けられ， null クラス 名が 付けられた 他の セグメントと 一緒 
に 連続した ブロック として ロード されます. • 

LINK では， 1 クラス 内の セグメント 数 や 大きさ は 無制限です. 1 クラス 内の すべての セグメ 
ントを 総計した 大きさが， 64K バイ ト 以上で あっても 構いません. 
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2.4.4 セグメントの 結合 

LINK は， 結合 タイプ を 使用して， 同一 の セグメント 名 を 共有す る 複数の セグメント を 単一 
の 大規模な セグメントに 結合すべき かどう か を 決定し ます. 結合 タイプと は， public, stack, 
memory, common, private 力 《あります. 

セグメ ントの タイプが public である 場合， Link は， 自動的に， これ を 同一 の 名前が 付けられ， 
同一 の クラスに 厲 する 他の すべての セグメントと 結合し ます. LINK は， セグメント を 結合す 
ると き， 確実に， これらの セグメントが 連統 してお り， これらの セグメント 内の すべての アド 
レスが 同一の フレームの ァ ドレスからの オフ セッ ト を 使用して アクセス 可能になる ようにし ま 
す. この結果， この セグメントが ソースファイル 内で 全体として 定義され ている 場合と 同一の 
ものが 生成され ます. 

LINK は， 各々 の セグメントの 位 匿 合わせの タイプ を 保存し ます. これ は， これらの セグメ 
ントが 単一の， 大規模な セグメントに 厲 していても， セグメント 内の コードお よび データ はも 
と の 位置 合わせ を 保存す ると いう 意味です. 結合され た セグメントが 64K バイトより 大きい 場 
合， LINK は エラーメッセージ を 表示し ます. 

セグメントの タイプが stack ま た は menory であ る 場合， LINK は public セグメントと 「ョ J 様 
の 結合 操作 を 行います. 唯一の 例外 は， stack セグメ ントの 場合， LINK が 最初の スタック ボイ 
ンタ値 を 実行可能 ファイルに コピーす る ことい うこと です. この スタックポインタ 値 は， 検出 
された 先頭の スタック セグメント （または 結合され た スタック セグメント） の 終わりまでの ォ 
フ セットです. 

セグメントの タイプが common である 場合， LINK は， 自動的に， これ を 同一の 名前が 付け 
られ， 同一の クラスに 厲 する 他の すべての セ グメン ト と 結合し ます. しかし LINK は， common 
セグメント を 結合 するとき， 各 セグメントの 開始 点 を 同一の アドレスに ロードし， 一連の ォ一 
バ ラップした セグメント を 作成し ます. この結果， 結合され た 最大の セグメントと 同一の 大き 
さの 単一 の セグメントが 生成され ます. 

ソースファイル 内で， セグメ ント のために 明示の 結合 タイプが 定義され ていない 場合の み， 
この セグメントの タイプが private になります. LINK は， private セグメント は 結合 しません. 
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2.4.5 グループ • 

グループ によって， 連続して おらず， 同一 の クラスに 厲 していない セグメント は， 同一 のフ 
レーム ァ ドレスからの 相対 ァ ドレスで， ァ ドレス 指定す る ことができます. 

LINK は， グループ を 検出した とき， この グループ 内の 項目に 対する すべての メモリ 参照が， 
同一 の フレーム ァ ドレスからの 相対 ァ ドレスになる よう に， これらの 参照 を 調整し ます. LINK 
は， グループの すべての 要素が 同一の 64K バイ トメ モリ 内に 収まる かどう か を チヱ ック しませ 
ん. . 

グループ 内の セグメント は， 連続して いる 必要 はなく， 同一 の クラスに 厲 する 必要 もな く， 
結合 タイプが 同一で ある 必要 もありません. グループ 内の すべての セグメントが， 64K パイ ト 
内に 収まる こと だ けが 必要 とされます. 

グループ は， セグメントが ロード される 順序に 影 » を 及ぼしません. クラス 名 を 使用せ ず， 
ォブ ジヱク ト ファイル を 正しい 順序で 入力し なかった 場合， セグメ ントが 連続して いると いう 
保障はありません. 実際に， LINK は， 同一の 64K バイ トメ モリ 中に この グループに 厲 さない 
セグメント を ロードす る 可能性が あります. LINK は， グループ 内の すべての セグメントが 64 
K バイ 卜の メモリ 内に 収まって いる こと を 明示で チヱ ック しません が， この 要件が 满 たされな 
い 場合， 解決 オーバ フロー エラー を 検出す る 可能性が あります. • 

2.4.6 参照の 解決 

いったん， プログラム 中の 各 セグメントの 開始 アドレスが 知られ， すべての セグメントの 組 
合せお よび グループが 確立され てし まう と， LINK は， ラベルお よび 変数に たいする すべての 
未解決の 参照 を 、、解決〃 する ことができます. 未解決の 参照 を 解決す るた めに， LINK は 該当 
する オフ セッ ト および セグメントの アドレス を 計算し， アセンブラ によって 生成され た 一時的 
な 値 を 新規の 値で 置き換えます. 

LINK は， 以下の 4 つの 異なった 参照 を 解決し ます. 

•Short 

•Near Self- Relative 
• Near segment 一 Relative 
•Long 

計算すべき 値の 大きさ は， 参照の タイプに 依存し ます. LINK は， 期待され た 大きさの 参照 
において エラー を 検出した 場合， 未解決 オーバ フロー メッセージ を 表示し ます. この こと は， 
たとえば， プログラムが， 16 ビッ 卜の オフ セッ トを 使用して， 異なった フレーム アドレス を 持 
つ セグメント 内の 命令に アクセスし ようとし た 場合， 発生す る 可能性が あ ります. この こと は， 
また， グループ 内の すべての セグメントが 単一の 64K バイ ト ブロックの メモリ 中に 収まらな 
かった 場合に は， 発生す る 可能性が あります. 
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short 参照 は， JMP 命令が， 同一の セグメント または グループ 内に ある ラベルの 付いた 命令 
に 制御 を 渡そうと するとき， 行なわれます. 目標 命令 は， 参照 点から 128 バイトの ところに な 
ければ なりません • LINK は， この 参照の ために， 符号 付きの 8 ビットの 数 を計爲 します. 
目標 命令が 異なった セグメ ン ト または グループに/ « する （異なった フレーム ァ ドレス を 持つ） 
か， または 目標までの 距離が 128 バイトより 遠い （いずれ かの 方向) 場合， LINK は エラー メッ 
セージ を 表示し ます. 

near self -relative 参照 は， 命令が 同一の セグメント または グループからの 相対 アドレスに 
ある データに アクセス するとき， 行なわれます. LINK は， この 参照の ために， 16 ビット オフ 

セット を 計算し ます. この データが 同一の セグメント または グループ 内 にないと き， LINK は 
エラー を 表示し ます. 

near segment-relative 参照 は， 命令が， 指定され た セグメ ン ト または グループ 内の データ， 
または 指定され た セグメ ン ト レジスタからの 相対 ァ ドレスに ある データに アクセス しょうと し 
たと き， 行なわれます • LINK は， この 参照の ために， 16 ビットの オフセット を 計算し ます. 
指定され た フレーム 内の 目標の オフ セッ トが 64K より 大きい か， または ゼロより 小さい 場合， 
あるいは この 目 棟の 標準 フレームの 開始 点をァ ドレス 指定で きない 場合， LINK は エラー メ ッ 
セージ を 表示し ます. 

long 参照 は， CALL 命令 力；， 他の セグメ ン ト または グループ 内の 命令に アクセスしょう と し 
たと き 行われます. LINK は， この 参照の ために， 16 ビット フレーム アドレス および 16 ビッ 
ト才 フセッ トを計 » します. 計算され た オフ セッ 卜が 64K より 大きい か， または ゼロより 小さ 
い 場合， あるいは この 目標の 標準 フレームの 開始 点が アドレス 指定で きない 場合， LINK はェ 
ラー メッセージ を 表示し ます. 

2.4.7 ローデ イングの 順序の 制御 

実際の セグメ ントを ロードしたい 順序で， 空の セグメ ン ト 定義が 示されて いる ダミー プ ログ 
ラム ファイル を 作成し， アセンブル する ことによって， プログラム 中の セグメントの ロー ディ 
ングの 順序 を 制御す る ことができます • いったん， この ファイルが アセンブル される と， LINK 
を 呼び出す とき， 単に この ファイル を 先頭の オブジェクト ファイル として 指定し ます. LINK 
は， これらの セグメント を 指定され た 順序で 自動的に ロードし ます. 

たとえば， つぎの ダミー プログラム ファイル は， CODE, DATA, STACK, CONST, およ 
び MEMORY という 名前の セグメ ント によって 構成され る プログラム 中の セグメ ントの ロー 
デ イングの 順序 を 定義し ます. 
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い 八 Pv 「 

し ODE 


segment 


CODE' 


CODE 


ends 




CONST 


segment 


CONST' 


CONST 


ends 




DATA 


segment 


'DATA' 


DATA 


> 

ends 




STACK 


segment 


stack 'STACK， 


STACK 


ends 




MEMORY 


segment 


'MEMORY, 


MEMORY 


ends 





この ダミー プログラム ファイルに は， プログラム 中で 使用すべき すべての クラスの ための 定 

« が 入って いなければ なりません. そうでない 場合， LINK は 省略時の ローデ イングの 順序 を 
選択し ますが， これ は ユーザーが 希望す る 順序と 一致す る 場合と しない 場合が あります. プロ 
グラム を リンク するとき， この ダミー プログラムが， LINK コマンド 行で 指定され た 先頭の ォ 
ブジェク トフ アイ ル でなければ な りません. 

注意 

ダミー プログラム ファイル を， C, Pascal, ま た は 他の 高級 言語の プロ グラムと一 緒に， ダミー 
プログラム ファイルと 一緒に 使用して はなり ません. これらの 言語 は， それ 自身の 口一 ディン 

グ 順序 を 定義し ます. これらの 順序 を， 修正して はなり ません. 

、 

MEMORY セグメント を プログラム 中の 最終 セグ メン 卜と して ロードす るよう に LINK に 強 
制する ことができます • 空の セグメント は， つぎのように 指定され なければ なりません • 

segment-name SEGMENT MEMORY 'class-name' 



segment-name ENDS 



segment- name は MEMORY セグメント のために， class-name は メモリ クラスの ために 使 
用したい 名前です， 

例： 



MEMORY 
MEMORY 



segment 
ends 



memory 



'MEMORY' 
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2.5 メッセージ 

リ ン 力； LINK の 表示す る メッセージ を アルファべ ッ ト 順に 解説し ます. 
About to generate . EXE file. 

Change diskette in drive <d: > and press <ENTER> 

.EXE ファイル を 生成す る 処理 を 休止して います. EXE ファイル を 収める ディスク をド 
ライブく d:> に セット （交換） して， リターン キー を 押してく ださい. これ は，/ P ス 
イッチ を 指定した とき に 表示 される メッセ 一 ジ です. 

Ambiguous switch error: 'x' 

スィッチ 名 を « 略しす ぎて， 一意に 確定で きません. スィッチの 最小の 省略 形 を 確認し 
てくだ さい. たとえば， つぎの ような スィッチの 指定 をす ると， この メッセージが 表示 
され， LINK は 処理 を 中止し ます. 

A > LINK /N main; 

Array element size mismatch 

コモンな アレイ 領域が， 2 ケ 所以 上で， 異なる サイズの エレメント （文字 型 と 実数 型な ど） 
で 宣言され ています. （現 バージョンの MASM では， コモンな アレイ は サポート されて 
いません.） 

Attempt to put segment く name〉 in more than one group in file 
<filename> 

く filename) 中の セグメント く name〉 は， 2 つの グループで 重複して 定義され ています. 
ソースファイル を 修正して， オブジェクト ファイル を 作り直して ください. 

Bad value for cparMaxAlloc 

/CPARMAXALLOC スィ ツチで 指定した 数値が， 1〜65535 の 範囲に ありません でし 

た. > 

Cannot find library ： く filename) . lib. Enter new file spec: 

指定され た ライ ブラ リファイ ル く filename) . lib が 見つか りません. ドライブ 名， パス 名， 
ファイル 名 を 確認して， 正しい ファイル 名 を 入力して ください. 

Cannot nest response files 

応答 ファイル 中に， さらに 応答 ファイル 名が 含まれて います. 応答 ファイル は 入れ子に 
できません. 応答 ファイル を 修正して ください. 
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Cannot open list file 

ディスク または ディレクトリが 一杯で， リスト ファイル を 作成で きません • ディスク ま 
たは ディ レクト リの 空き スペース を 作って ください • 

Cannot open response file 

応答 ファイル を オープンで きません • ファイル 名の ミス タイプに よる 可能性が高いと 考 
えられます， 

Cannot open run file 

ディスク または ディレクトリが 一杯で， 出力 （実行可能） ファイル を 作成で きません • 
ディスク または ディ レク ト リの 空き スペース を 作って ください. 

Cannot open temporary file 

ディスク または ディレクトリが一 杯で， 一時 作業 ファイル （VM.TMP) を 作成で きま 
せん. ディスク または ディ レク ト リの 空き スペース を 作って ください • 

Cannot reopen list file 

LINK を 起動した ディ スクが 交換され たために， リス ト ファイル を 再 オープンで きませ 
ん でした • LINK を 再起動して ください. 

Common area longer than 65536 bytes 

ユーザー プログラムが， 64K バイ ト 以上の コモン 変数 を 持って います • 

Data record too large 

オブジェ ク トモ ジュール 中の LEDATA レコードに， 1024 バイ ト 以上の データが 入って 
います. • 

Dup record too large 

ォブ ジヱク トモ ジュール 中の LIDATA レコードに， 512 バイ ト 以上の データが 入って い 
ます. アセンブリ モジュール 中の 構造 定義が 複雑す ぎたり， DUP ステートメントの ネス 
卜が 深す ぎる （例： ARRAY db 10 dup (11 dup (12 dup (13 dup (•••) ) ) ) こ とが 原 

因と 考えられます • ソースファイル を 修正して ください • 

<filename> is not a valid library 

指定した ライブラリ ファイル く filename) に 問題が あります. 
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Fixup overflow near <num> in segment <name> in く filename) (name) offset 
<num> 

この メッセージが 出力され る 原因と して は， つぎの ような 状況が 考えられます • 1)1 グ 
ループが 64K バイト 以上 ある • 2) ユーザー プログラム 中に， セグメントに またがる 
short ジャンプ/コールが 含まれて いる • 3) リンクす る ライブラリ 中の ルーチンと， 同 
—の データ 項目 名が 使われて いる. 4) セグメントの 本体 中で， EXTRN が 用いられ てい 
る. この 例 をつ ぎに 示します • 

CODE segment public 'code' 
extrn main: far 



start 



proc 

call 

ret 



far 
main 



start endp 
CODE ends 

前例 を 修正した もの をつ ぎに 示します. 

extrn main: far 
CODE segment public 'code' 
start proc far L 
call main 
ret 

start endp 
CODE ends 

ソースファイル を 修正して， 再度 アセンブルして ください. 

Incorrect DOS version, use DOS 2.0 or later 

この LINK は， MS-DOS Ver 2.0 以上で お使いく ださい • 

Insufficient stack space 

メモリ 不足で， LINK を 実行で きません. 



Interrupt number exceeds 255 

/OVERLAYINTERRUPT スィッチで, 255 よりも 大き な 値が 指定 されて います. 指定 
できる 値の 範囲 は， 4〜255 です. 
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Invalid numeric switch specification 

スィッチに， 無効な パラメータが 指定され ています • 数値 を 指定す るべき ところで 文字 
を 指定して いる （0 と 0 の 間違い)， など も 原因と して 考えられます. 

Invalid object module 

オブジェ ク トモ ジュールに 問題が あります • アセンブル または コンパイルし なおして く 
ださい. 

NEAR/HUGE conflict 

コモン 変数の near と huge 定義に， 重複が 生じて います • （現 バージョンの MASM で 
は， コモン 変数 は サポートされ ていません.） 

Nested left parentheses 

オーバーレイ を 指定す る， LINK の コマンド ラインに， 文法的な 誤りが あります • 

No object modules specified 

オブジェ ク 卜 ファイルが 指定され ていません. 

Out of space on list file 

リスト ファイル を 害き 出し 中の ディスクが一 杯に なり， 全部 を 収められません • デ イス 
クの 空き スペース を ふやして， LINK を 再起動して ください • 

Out of space on run file 

EXE (実行可能） ファイル を 書き出し 中の ディスクが 一杯に なり， 全部 を 収められ ませ 
に ディスクの 空き スペース を ふやして， LINK を 再起動して ください. 

Out of space on scratch file 

カレント ドライブの ディスクが 一杯に なって しまいました. ディスクの 空き スペース を 
ふやすな どして， LINK を 再起動して ください. 

Overlay manager symbol already defined: く name> 

ユーザ一 が 定^した シンボル 名と， オーバーレイ マネージャ 名が 重複して います • 名前 
を 変更して， 再処理して ください. 

Please replace original diskette in drive <d: > and press ENTER 

LINK を 起動した （ォ リ ジ ナル） ディスク を ドライブく d:> に セット して， リターン キ一 
を 押してく ださい • これ は， /P スィッチ を 使用した ときに 表示され る メッセージで， 
EXE ファイル を 害き 出し 終わる と 出力され ます. 
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Relocation table overflow 

16384 バイ トを 越す， long コール/ジャンプ Z ポインタが 使われて います. long 参照 を 
short 参照に 換えて， 再処理して ください. 

Segment limit set too high 

/SEGMENT スィッチ で 指定 し た 数値が 大 きすぎ ます. 

Segment limit too high 

/SEGMENT スィッチ で 指定 し た 値 （ ま た は 初期設定 値 ： 128) で， アロケート テーブル 
を 作る に は， メモリが 不足して います. 値 を 小さく する か， メモリの フリー エリア を 広 
げ てくだ さい. 

Segment size exceeds 64 K 

セ グメン ト サイズの 制限， 64K バイ トを 越えて います. たとえば， ユーザー プログラム 
は， 小規模 メモリ モデルで ありながら 64 K バイ ト 以上の コード， 中規模 メモリ モデルで 
あ り ながら 64 K バイ ト 以上の データ を 持って います. 中規模 • 大規模 メ モ リ モデルで, 
コンパイルと リ ンク 処理 を 行って ください. 

Stack size exceeds 65536 bytes 

/STACK スィッチで 指定した 値 力 5, 65536 バイ トを 越えて います. 

Symbol table overflow 

ユーザー プログラムが， 256 KB 以上の シンボル 情報 （public, extrn, segment, group, 
class, file など） を 含んで います. セグメ ントゃ モジュールの 結合な ど を 行って， オブジェ 
ク ト ファイル を 作り直して ください. 

Terminated by user 

ユーザーの 回 キー入力 によって， リンク 処理が 中止され ました • 

Too many external symbols in one modul 

ユーザーの 才ブ ジヱク トモ ジュール 中の 外部 シンボルが 多過ぎます. モジュール を 分割 
するな どして ください. ' 

Too many group -， segment-, and class-names in one module 

ユーザ— プログラム 中の グループ 名， セグメント 名， クラス 名が 多過ぎます. 数 を滅ら 
して， オブジェクト ファイル を 作り直して ください. 

Too many groups i 

ユーザー プログラム 中で， 10 個 以上の グループ を 定義して います. 



2.5 メッセージ 



Too many GRPDEFs in one module 

1 モジュール 中に， 10 個 以上の GRPDEF があります. 数 を 減らす 力、， モジュール を 分割 
してく ださい， 

Too many libraries 

17 個 以上の ライ ブラ リファイ ルを 指定して います， 16 個 以下に してく ださい • 

Too many overlays 

ユーザー プログラム 中で， 64 個 以上の オーバ一 レイ を 定義して います • 数を滅 らして く 
ださい. 

Too many segments 

ユーザー プログラム 中の セグメ ントが 多すぎます. ZSEGMENT スィ ツチの パラメ 一 
タを 適当な 数値に ふやして， 再び リンク 処理 を 行って ください. 

Too many segments in one module 

オブジェ ク トモ ジュールに， 256 個 以上の セグメ ントが 含まれて います. オブジェクト を 
分割す るか， セグメント を 連結して 数を滅 らして ください. 

Too many TYPDEFs 

オブジェ ク トモ ジュール 中の TYPDEF レコードが 多過ぎます • この レコード は， コンパ 
イラが コモン 変数の 領域の ために 生成した ものです， （現 バージョンの MASM は， コモ 
ン 変数 をサ ポー ト していません.） 

Unexpected end-of-file on library 

ライブラリ を 収めた ディスク 力、 外された 可能性が高いと 考えられます • ディスク を 確 
認 してく ださい. 

Unexpected end-of-file on scratch file 

VM.TMP ファイルの 作られて いた ディ スク が， 外された 可能性が高いと 考えられ ま 
す. ディスク を 確認して， LINK を 再起動して ください. 

Unmatched left parenthesis 

オーバーレイ を 指定す る LINK の コマンド ライ ンに， 文法 エラ一 があります • 

Unmatched right parenthesis 

オーバ— レイ を 指定す る LINK の コマンド ライ ンに， 文法 エラーが あります. 
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Unrecognized switch error: 'く filename) ， 

' 無効な 文字が， スィッチ として 指定され ています. たとえば， つぎの ような スィッチ は 
存在し ません. 

A> LINK /ABCDEF main; 

LINK は 処理 を 中止し ます. 

VM . TMP is an illegal file name and has been ignored 

ユーザーの 才 ブジェク ト ファイル 名に や VM.TMP" が 使われて います. ファイル 名 を 
変更して ください. 

Warning ： no stack segment 

ユーザー プログラム は， スタック スペース セグメント を 割り当てる ステートメント を 含 
んで いません. 

Warning ： too many local symbols 

ローカル シンボルの ソート （並び 換え） リスト を 要求し ましたが， シンボル 数が 多過ぎ 
て， ソートで きませんでした. LINK は， ソートし ていない ローカル シンボルの リスト 
を 作成し ました. 

Warning: too many public symbols 

パブリック シンボルの ソート （並び 換え） リスト を 要求し ましたが， シンボル 数が 多 過 
ぎて， ソートで きませんでした. LINK は， ソートし ていない パブリック シンボルの リ 
スト を 作成し ました. ^ 05J^9Q/ 
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SYMDEB •• シンボリック デ / \ッグ ユーティリティ 

3.1 イン トロ ダ クシ ヨン 

SYMDEB は， 管理され た 検査 用の 環境 を 提供す る デバ ッ ガで， 実行可能な プロ グラム やその 
他の バイナリファイルの ロード， 検査 や 修正 を 行います. 

SYMDEB では， プログラム コードの 表示， レジスタの 検査， ブレーク ポイントの セッ ト およ 

び 命令 実行の ト レースが 可能で あり， マイクロ ソフト 言語が 使用す る 浮動小数点 ェ ミュレ 一 

シ ヨンの 愼例を 用いた プログラム を デバッグ できます. 
SYMDEB は， シン ボリ ック デバッグ ユー ティ リ ティで あり， データ や 命令の 参照 を アドレス 

ではなく， 名前 （シンボル） で 行う ことができます. 名前 を 入力 すれば 変数の 表示 や ルーチン 

の 実行が でき， アドレス を 入力す る 必要はありません. 
SYMDEB では， プログラム 内の パブ リ ック シンボルの ァ ドレス 情報の 入った シンボル マツ 

プ ファイル （.SYM ファイル） を いれる ことができます. シンボル マップ ファイル は， MAP- 
SYM (シンボル マップ ファイル ユー ティ リ ティ） および LINK の 作る マップ ファイル を 用いて 

作成し ます. 

SYMDEB の ブレーク ポィ ント コマンド は， プログラム コードの ブレーク ポィ ントの セット， 
有効 化， 表示お よび ク リア を 実行し ます. この ブレーク ポイント は， どんな 命令に あっても， 
プロ ダラ ムの 実行 を 停止 さ せ， 無効 化す る か 削除す る ま では 有効です. 

SYMDEB の 式 評価 機能 は， シンボルと 数に 関する 演算 を 行います. セグメ ン ト値ゃ オフ セッ 
ト シ ン ボル か ら の 抽出 を 含む すべての 算術 演算， ブー ル 演算お よび アドレス の 演算が 可能です. 
オペランドの 参照 は， 値， アドレス または ポート 番号で 行います. 

• ソース 行の 表示と 番号 付け 

SYMDEB の 強力な 機能と して， ソース 行の 表示と 番号 付けが あります. この 機能に よって， 
C や Pascal, FORTRAN などの プログラムの デバッグが， 機械 レベル だけでなく， ソース ファ 
ィ ルレ ベルで も 行えます. 

表示 レベル は SYMDEB コマンドで 選択で き， プログラムの 実際の ソース 文 や 機械語， また 

は それら を 組み合わせた ものの 表示が 可能です. 

さらに SYMDEB は， 表示 コマンドと ブレーク ポイント コマンドへの 引数と して， ソース 行 
番号 を 受け取ります. これによ つて， ソースファイルの 個々 の 文の 参照 は， その メモリ 内の 正 
確な 位置 を 知らな くても 《ラぅ ことができます. 
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mzf^. SYMDEB ： シン ボリ ック デバッグ ユー ティ リ ティ 



本章で は， SYMDEB の 使用方法， 特に プログラム を デバッグ する 際の デバッガの 起動 方法, 
シンボル し SYM) フ アイ ルの 作成 方法お よ び 使用方， SYMDEB コ マン ドの 使用方法 について 
説明し ます. 



3,2 SYMDEB の 起動 

SYMDEB は， MS-DOS の コマンド プロンプトに その 名前 を タイ プ すれば 起動で きます， 
SYMDEB を 呼び出す ときの 害 式 をつ ぎに 示します. 

SYMDEB [く シンボル ファイル 名〉] [く デバッグ ファイル 名〉 [く 引数 リスト〉]] 

シンボル ファイル シンボル ファイル （.SYM) に 名前 をつ ける オプションの ファイル 名. 
ファイル 名 ロードす る バイナリ フ アイ ルゃ 実行可能 フ アイ ル に 名前 を 付け る才プ 

シ ヨンの ファイル 名. 

引数り スト ォ ブショ ンの プロ グラム 引数の リ ス ト. SYMDEB では， ロード された 

プログラムが この 引数 リ ス ト を 利用で きる ようになつ ている. 

起動 後， SYMDEB は メッセージ を 表示し， つづいて SYMDEB プロンプト （-) を 表示し ま 
す. ブロン ブトが 示されたら， SYMDEB コマンド を 入力で きます. 



例： 



A > symdeb 

Microsoft Symbolic Debug Utility 
Version 3.01 、 : 
I (C)Copyright Microsoft Corp 1984, 1985 
Processor is [80286] 



前記の 例に おいて， 、、symdeb" は， MS-DOS コマンド 行に タイプ されます. コマンド は， 始 
動 メッセージと SYMDEB プロンプト （-) を 表示し ます. 
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3.2.1 デバッグ ファイル を 指定した SYMDEB の 起動 

SYMDEB を 起動す る コマンド ライン 上に， デバ ッグ したい フ アイ ル名を 指定す る ことに 
よって， 実行可能な プログラム ファイル （.EXE または. COM) を ロードで きます. たとえば， 
SYMDEB の 起動時に フ アイ ル lile . exe" を ロードす る 場合に は， つぎのように タイプし ます. 

symdeb file, exe 

プログラム フ アイ ルが ロー ド さ れた 場合， SYMDEB は， 使用可能な メモリ の 最下位の セグメ 
ン トに， 256 バイ 卜の プログラム 用の ヘッダ を 作成し， 次に ファイルの 内容 を ヘッダの 直後の 空 
き メモリに コピーし ます. SYMDEB は， ファイルの 大きさ （バイト 単位） を BX:CX レジス 
タに コピーし， セグメント と 他の レジスタ を ファイルが 定義す る 個々 の 値に 合わせます. 

3.2.2 シンボル ファイル を 用いた SYMDEB の 起動 

シンボル 演算 を 行う 場合 は， コマンド 行に 1 つまた は 複数の シンボル ファイル を 入力して 
SYMDEB を 起動し ます. シンボル ファイル を 入力す ると， SYMDEB は， 入力され た ファイル 
を ロードし， その フ アイ ルが 定義す る シン ボルの 使用 を 可能に します. 

ロードす る シンボル ファイル は， MAPSYM コマンドで 作成し ます. 後述の め シンボル ファ 

ィルの 作成" の 項 を 参照して ください. 

たとえば， プログラム ファイル や file. exe か と共に， シンボル ファイル Afii e . sym " を ロー 
ド する 場合の 入力 は， つぎのように なります. 

symdeb file, sym file, exe 

SYMDEB は， 、、file.sym" から メモリへ と シンボル 情報 を コピーし， プログラムの ヘッダ 

を 作成した 後に， "ile.exe" を ロードし ます. ： 
複数の シンボル ファイル を 入力す る こと もで きます. 一般に， 複数の シンボル ファイル は， 
別々 に リンク された 数個の プログラム ファイル からなる プログラムに 使用し ます. しかし， す 
ベての シンボル ファイル は， 必ず プログラム ファイル 名の 前に 入力し なければ なりません. プ 
ログ ラム ファイルの 後に 入力され た ファイル は， すべて プログラム 引数と みなされます. 

シンボル を ロードす る 場合に は， プログラム ファイル を ロードす る 必要 はあり ません. 
SYMDEB は， ファイル 名 を 用いずに 起動した かの ように 起動し ます C ファイル を 用いない 
SYMDEB の 起動〃 の 項 参照). 
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3.2.3 引数の ロード 済 プログラムへの 引き渡し 

SYMDEB コマンド ライ ン 上の プログラム フ アイ ル 名の 直後に 引数 を タイプす る ことによ つ 
て， ロード 済の プログラムへ， 1 つまた は それ以上の プログラム 引数 を 引き渡す ことができ ま 
す. SYMDEB は， すべての 引数 を 入力され たと おりに， プログラムの ヘッダに コピーし ます. 

たとえば， データファイル、、 test.dat 〃と， オプションの、、 Zm 〃と、、 Zb" を プログラム ファ 
ィル 、、file.exe〃 へ 移動させる 場合 は， つぎのように タイプし ます. 

symdeb file . sym file . exe test . aat /m /b 

SYMDEB は 文字列^ est. dat /m /V を プログラム ヘッダに 置き， それから "ile.exe" 

を ロードし ます. 引数 を ロードして しまえば， 、、file. exe" は プログラムから いつでも 引数 を 読 

み 取る ことができます. 

プログラム ヘッダの 詳細に ついては， 後述の 、、Name コマンド〃 の 項 を 参照して ください. 

3.2.4 ファイル を 用いない SYMDEB の 起動 

SYMDEB は， ファイル を 用いなくても， 、、SYMDEB" と タイプす る だけで 起動で きます. 
フ アイ ル名を 用いないで SYMDEB を 起動す る と， SYMDEB は プロ グラムのへ ッ ダを 作成し 
ます 力;， プログラムの ロード は 行いません. この場合， Name コマンドと Load コマンド を 自由 
に 用いて， 希望の ファイルに 名前 を 付けたり， それ を ロードしたり できます. 

フ アイ ルを 用いないで SYMDEB を 起動す る と， SYMDEB は 空き メモ リ の 最下位に セグメ 
ント レジスタ をセッ 卜し， 命令 ポインタ を 0100H にセッ 卜し， すべての フラグ をク リアし， 他 
の レジスタ を 0 に セットし ます. 

3.2.5 シンボル ファイルの 作成 

SYMDEB が デバッグ する プログラム で 使用 する シンボル ファイル は， M APS YM プロ グラ 
ムを 用いて 作成し ます. この プログラム は， プログラムの シンボル マップ ファイル （.MAP) 
の 内容の 書式 を SYMDEB を 用いた ロードに 合うよう に 変換 します. 

MAPSYM コマンドの 害 式 は， つぎのと おりです. 

MAPSYM [一 IIZI] ファイル 名 

ファイル 名 は， リンク 時に 作成され る シンボル や マップ (.MAP) の ファイルの ことで， ファ 
ィル 名の 拡張 子 を 入力 しないと、、. MAP" と 解釈され ます. シンボル マップ ファイル は， マツ 
プ ファイル を 指定して， LINK コマンドで スィ ツチ や/ MAP" を 指定 すれば 作成で きます. ソー 
ス 行の デバッグ を 行いたい 場合 は， 同様に， スィッチ や ZLINENUMBER" を 入力す る 必要が 
あります. 詳しく は， 第 2 章 、、LINK: リンカ〃 を 参照して ください. • 
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3.3 コントロール キーの 使用 



任意 選択の "一 1" と、、 /1 "は 同じ もので， プログラムに 定義され た グループ 名， プログラムの 
開始お よ び 行 番号の 有無な どの 変換に 関する 情報 を， MAPSYM に 表示 させます. 

たとえば， マップ ファイル、、 file.map" から シンボル ファイル や file.sym な を 作成す る 場合 
は， つぎのように タイプし ます. 

mapsym file, map 

MAPSYM プログラム は 新しい ファイル を 作成し， シンボル 情報 を その ファイルに コピーし 
ます. 

注意 

作成す る シンボル ファイルの ファイル 名と して パス を 指定す る こと はでき ません • 

3.3 コントロール キーの 使用 

誤りの 修正 や コマンドの 停止 は， MS-DOS ユーザーズ ガイ ドで 述べられ ている コン ト ロー 
ル キャラクタ や テンプレート 機能 を 用いれば 行えます. 以降の 項で は， コマンドの 停止 方法と 
保留 方法に ついて 述べます. 

3.3.1 SYMDEB コマンドの 停止 ぐ 、 

SYMDEB コマンド は， [^U1 +[^1 キ一 を 押せば, いつでも 停止させる ことができます. こ 
の キーに よって SYMDEB は， 実行中の コマンド を 停止して， SYMDEB プロンプト を 表示し 

ます， " 08 

一般に， [^U1 + [^キー は, 長い Dump コマンド を 停止す る 場合に 用います. この キー は， 無 
限 ループ を 入力した Go コマンドから 制御 を 取り除く 場合に も 使用で きます が， それ は， プ ログ 
ラムが 入力 または 出力 処理 を 実行して いる 場合に 限られます. ' 

)3l 急 

SYMDEB の 入力が Redirection コマンド を 用いて や AUX" に 向けられた 場合 は， ICTRU + 
回 キー は 無効で， 無視され ます. 
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3.3.2 コマンドの 保 S 

symdeb の 出力 は， r^n + [^キー を 押せば， —時 的に 保留させる ことができます • 

SYMDEB は， 別の キー を 押される まで は， コマンドの 出力 を 中断し ます. 一般に， ICTRLI + 
[D キー は， 特定の バイ トゃ 命令 を 検査す るた めに， Dump コマンド や Unassemble コマンドの 
出力 を 一時的に 止める 場合に 用います. 

ミ 主意 SYMDEB の 入力が Redirection コマンド を 用いて に 向けられた 場合 は， ， 
[^El+[1] キー は 無効で， 無視され ます. 



3.4 コマンド 

次の 表に， すべての SYMDEB コマンド を 示します. 



？ 


値の 表示， ヘルプ 表示 


EW 


ヮー ド 入力 


< 


入力の 切り換え 


ED 


ダ ブルワー ト 入力 


> 


出力の 切り換え 




短い 実数の 入力 




入力と 出力の 切り換え 


E し 


長い 実数の 入力 


！ 


MS-DOS コ コマンドの 実行 


ET 


10 バイ ト 実数の 入力 


- 


現在の ソース ラインの 表示 


F 


フィル 


* 


コメン トの 表示 


G 


あ 行 


A 


アセンブル 


H 


16 進 計算 


BP. 


ブレーク ボイ ントの 作成 


1 


ポート 入力 


BC 


ブレーク ボイ ン トのク リア 


K 


ス タツ フレームの 表示 


BD 


ブレーク ボイ ントの 無効 化 


し 


ロード 


BE 


ブレーク ボイ ン 卜の 有効 化 


M 


移動 


BL 


ブレーク ボイ ントの リスト 


. N 


名前の セッ ト 


c 


比铰 


0 


ポート 出力 


D 


ダンプ 


P 


P トレース 辦 


DA 


ASCII ダンプ 


Q 


中止 


DB 


バイ ト ダンプ 


R 


レジスタ 


DW 


ワード ダンプ 


S 


サーチ， ソース 形式の セッ ト 


DD 


ダブル ワード ダンプ 


T 


ト レース 


DS 


短い 実数の ダンプ 


U 


逆 アセンブル 


DL 


長い 実数の ダンプ 


V 


ソース ラインの 表示 


DT 


10 バイ ト 実数の ダンプ 


w 


害き 込み 


E 


入力 


X 


シンボル マップの 検査 


EA 


ASCII コード 値 入力 


xo 


シンボル マップの 解放 


EB 


バイ ト 入力 


z 


シン ボリ ック アドレスに 値 をセッ ト 
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3.4 コマンド 



3.4.1 コマンド 書式 

すべての SYMDEB コマンド の 一般 害 式 はつぎの とおり です. 

くコ マン ド名〉 く パラメータ〉 … 

く コマンド 名〉 は， 1'2 文字の アルファべ ッ ト による コマンド 名です. 

く パラメータ〉 は， コマンドが 使用す る 値 や アドレス を 表す 数 や シンボル や 式です. コ マン 
ド 名と パラメータに は， 大文字と 小文字 を どのように 組み合わせて 用いても 構いません. 

コマンドの パラメータの 数 は， その コマンド によって異なり ます. コ マン ドが 複数の パラメ一 
タを 持つ 場合 は， 1 つの カンマ （，） または スペース （空白） によって パラメータ を 区切りな が 
ら 並べます. 

例： 

D cs ： 100 110 
U cs ： 100 110 

F ds: 100, 110 ff, fe, 01, 00 

以後の 項で は， コ マン ドの バラ メータに ついて 詳しく 説明し ます. 

3.4.2 シン ポル 

シンボル は， レジスタ， 絶対値， セグメント アドレス， または セグメントの オフセット を 表 
す 名前です. シンボル は， 1 つまた は 複数の 文字から 構成され ますが， 必ず， 文字， アン ダース 
コア （― )， 疑問符 （？ )， アット 記号 （@)， ドル記号 （$) で 始まります. Y 

レジスタ を 指名す る シンボル は， 常に 使用可能です （すべての 表に ついては， や Registar コマ 
ンド" の 項 を 参照して ください）. 他の シンボル は， その シンボルの 名前 や 値 を 定義す る シンポ 
ル マップ ファイルが ロードされ ている 場合に のみ 使用す る ことができます. 

洤意 

SYMDEB は， 大文字と 小文字 を， 同じ 文字と して 扱います. 

スペルの 違いが 大文字 *小 文字 だけで ある シンボル は， 同じ ものと して 扱われます. シンボル 
マップ ファイルに そのような 2 つの シンボルが ある 場合， SYMDEB は そのうちの 1 つ だけ を 
承認し ます. もう 一方の シンボルに ついての 情報 を アクセスしょう とすると， 常に 最初の シン 
ボルに ついての 情報が 返って きます. 

レジスタ 名と 同じ スペルの シンボル は 無視され ます. レジスタ 名 は， 常にそう いった シンポ 
ルに 優先し ます. 
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例 ： 

AX 
main 
DGROUP 
IP 

3.4.3 数 

SYMDEB では， 2, 8， 10, 16 進数 を 用いる ことができ， 添え 字で 基数 を 表します • 数字の 
表記法の 害 式 はつぎの ような ものです. 

く 数字〉 Y 

く 数字〉 0 え 
く 数字〉 Q 
〈数字〉 T 
〈数字〉 H 

数 は 整数 を 表し， 2 進数 字， 8 進数 字， 10 進数 字， または 16 進数 字と オプションの 基数 を 組 
み 合わせた ものです. 数字 は， Y, 0, Q, T， H のうちから 指定され た 基数の 数字です. 基数 
が 入力され ない 場合 は， H (16 進） と 解釈され ます. 

つぎの 表で， 各々 の 基数で 使用で きる 数字 を 示します. ン 



添え 字 


タイプ 


数字 




Y 


2 進数 


01 v H , ； «y 




0, Q 


8 進数 


01234567 




T 


10 進数 


0123456789 




H 


： 16 進数 


0123456789 ABCDEF 





数に は， 数字 をい くつで も いれる ことができ ますが， SYMDEB では， 数が 65535 より 大きい 
場合 は， 先頭の 数字 を 切ります. また， 先頭に ゼロが あっても 無視され ます • 

例 ： 

0111111Y 77Q 63 T 3FH 3F 
01001010100101Y 112450 4773T 12AH 12A5 
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3.4 コマンド 

3.4.4 アドレス 

アドレスの 指定の 害 式 は， つぎの ような ものです. 

く セグメント〉 ： 〈オフ セッ ト〉 

アドレス は， セグメントの アドレス を 表す 値と， セグメント 中の オフ セッ トを 表す 値の， 2 つ 
の 16 ビッ トの値 を 組み合わせた ものです. 組み合わせた 値が， 特定の メモリ ァ ドレス を 指定し 
ます， 

完全な アドレス は， セグメント アドレスと， オフ セッ トを 持って おり， この 2 つ は コロン （ ： ） 
で 区切られます. 部分 アドレス は， オフセット のみです. どちらの 場合 も， セグメント や オフ 
セット は， 数 か レジスタ 名 または シンボルです. ほとんどの コマンドの 場合， 部分 アドレスに 
は， ^珞時 セグメ ント アドレスが 与えられます. 省略 値 は， DS セグメ ン ト レジスタの 最新の 内 
容 です. Assemble コマンド， Go コマンド， Load コマンド， PTrace コマンド， Unassemble 
コマンド， および Write コマンドの 場合， 省略時の セグメ ント アドレス は， CS レジスタの 内容 
です. 

例 ： 

cs: 0100 
04BA:IP 
CS: main 
DGROUP: count 

3.4.5 アドレス 範囲 
アドレス 範囲の 書式 は， つぎの ような ものです. 

く 開始 ァ ド レス〉 〈終了 ァ ド レス〉 

範囲 は， 連続して いる 記憶 位置の 順序 を 指定す る 2 つの 記憶 ァ ドレス を 組み合わせ たもので 
す. 開始 アドレスと 終了 アドレス は， 範囲の 最初と 最後の アドレス を 指定し ます. 

コマンドが レンジ をと つた 場合に， 2 番目の アドレス を 入力 しないと， SYMDEB は 常に 128 
バイ トの 範囲 を 想定し ます. コマンドが レンジ を 取って からすぐ に 3 番目の パラメータ を 続け 
た 場合 は， 2 番目の アドレス を 入力し なければ なりません. そうしな いと， SYMDEB は， 3 番 
目の パラメータ を 2 番目の ァ ドレスと して 使用して います. 

例： 

' cs ： 100 110 

—main —main + 20 
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3.4.6 対象 レンジ ♦ 

対象 レンジの 害 式 は， つぎの ような ものです. 、- 

く 開始 アドレス〉 L 〈値〉 

対象 レンジ は， メモリ アドレスと， メモリ 内の 連続した バイト， ワード， 命令， または その 
他の 対象の 範囲 を 指定す る 、、対象 物〃 の 総計 を 組み合わせた ものです. 開始 アドレス は， リス 
卜の 最初の 対象の アドレス を 指定し， やし 値〃 は， リスト 内の 対象 数 を 指定し ます. - . 

対象 レンジ は， Dump コマンド， Fill コマンド， Search コマンド， Unassemble コマンドで 
のみ 用いる ことができます. 各 コマンド は リスト 内の 対象の 大きさ や 種類 を 決定し ます. たと 
え ば， Dump Bytes コマンド は バイ ト を 持ち， Dump Words コマンド は ワード を， Unassem- 
ble コマンド は 命令 を 持って います. 

例： 

DGROUP: table L 100 
main L 20 

3.4.7 行 番号 

行 番号 は， ソース プログラム ファイル 中の テキスト を 含む 行 を 示します. 行 番号の 書式 は， 
つぎの ような ものです. 



.± 行 番号 
• [ファイル 名：] 番号 
- シンボル [土 行 番号] 

行 番号 は， 10 進数と ファイル 名と シンボル を 組み合わせ たもので， プログラム ソース フ アイ 
ル 内の テキス トの 特定の 行 を 指定し ます. 

最初の 形式の 害 式 は， 相対 行 番号 を 指定す る ものです. 番号 は， 現在の ソース 行から 新しい 
行までの オフ セッ ト （行 単位） です. プラス 記号 （+ ) を 入力した 場合， 新しい 行 は， ソ一 スフ ァ 
ィルの 終わり 寄りになります. マイナス 記号 （一） を 入力した 場合に は， 新しい 行 は， フ アイ 

場合， SYMDEB は エラー を 表示し ます. 

2 番目の 形式の 害 式 は， 絶対 行 番号 を 指定す る ものです. ファイル 名 を 入力す ると， 指定され 
た 行が， ファイル 名に よって 示された シンボル ファイルに 対応す る ソースファイル 内に ある と 
解釈され ます. ファイル 名 を 入力 しないと， 現在の 命令 アドレス （たとえば， CS レジスタ や IP 
レジスタの 現在の 値） が， その 行 を 含んで いる ソースファイル を 決定し ます. ファイル 名がない 
場合 や， 指定した 行に 対する ソース 行がない 場合， SYMDEB は エラーの 表示 を 行います. 

3 番目の 形式の 組み合わせ は， シンボル 行 番号 を 指定し ます. シンボル は， どんな 命令， また 
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は 手続き ラベルで あっても 構いません. 番号 を 入力す ると， その 数 は， 特定 ラベル や 手続き 名 
から 新しい 行までの オフセット （行 単位） となります. プラス 記号 （+ ) を 入力した 場合， 新し 
い 行 は， ソースファイルの 終わり 寄りになります. マイナス 記号 （一 ） を 入力した 場合に は， 新 
しい 行 は， ファイルの 先頭 寄りになります. シンボルがない 場合 や， 指定した 行に 対する ソー 
ス 行がない 場合， SYMDEB は エラーの 表示 を 行います. 

例： W^tM^ 



衮 記法 £ _ ^ ' 

.+5 ；現 ラインから 5 行 下の 行 

.10 ；現 ソースファイルの 10 行 目 

. sample ： 1 ； 、、sample" が 指定す る ソースファイルの 10 行 目 

.main ； ルーチン 、、main" の 1 行 目 ， 

.main + 5 ； ルーチン や main な の 5 行 目 



シンボル 、、main" は， 行 番号の 指定に も 使用で きます. この場合， 、、main な は た main" と 同 
じです. ただし， A ma i n + 3" が "main" から 3 パイ ト 目の アドレス を 指定す るのに 対して， 
、、main + 3" は， 、、main〃 から 3 行 目の ソース 行 を 指定す るので 注意して ください. 

3.4.8 ストリング 

ストリング は， 引用符で 囲まれた 文字列で， SYMDEB は 文字の ASCII 値 を 用います. スト 
リングの 害 式 は， つぎの ような ものです. 

, 文 宇 ， 
* 文字〃 

ス ト リ ング は， ASCII 値の く リス 卜〉 を 表します. ス ト リ ングは どのような 長さで もよ いく， 
シングル コー テーシ ヨン に） か ダブル コ一 テーシ ヨン （ゥ ) を 含める こと もで きます. ただ 

に 引用符 を 入れる とき は， SYMDEB がその ス ト リ ングを 早目に 終わらせ るの を 防ぐ ために， そ 
の 引用符 を 2 個つ づけて 入力す るか， 別の 種類の 引用符 を 用います. 

例 ： ， 
'This is a string . ' 
"This is a string ノ 
'This "string" is okay.' 
"This" "string" ^ is okay." 
' This ^string" is okay ノ 
"This 'string' is okay." 
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3.4.9 式 

式 は， 8 ビッ ト *16 ビッ ト *32 ビッ 卜の 値 を 求める パラメータと 演算子の 組み合わせです. 式 
は， すべての コマンドで， 値と して 用いる ことができます. 

式 は， すべての シンボルと 数字， アドレス を， つぎに 示す 単項 演算子お よび 2 項 演算子 を 用 
いて 組み合わせる こ とがで きます. 



• 単項 演算子 

演算子 

+ 

NOT 
SEG 
OFF 
BY 

WO 

DW 

POI 

PORT 

WPORT 

• 2 項 演算子 



« 味 

単項 ブラス ' ' ' 

単項 マイナス 
1 の 補数 

オペランドの セグメ ント アドレス 
オペランドの ァ ドレス オフセット 
特定 アドレスからの 下位 バイ ト 
特定 アドレスからの 下位 ワード 
特定 ァ ドレスからの ダ ブルワー ド 
特定 アドレスからの ポインタ （4 バイト） 
特定 ポートからの 1 バイ ト 
特定 ポー 卜からの ワード 



mm 
髙 



低 



* 



MOD 

+ 

AND 
XOR 
OR 



乗算 

整数の 除算 

余り 

セグメ ン 卜の オーバー ライ ド 
加算 

減算 
論理 積 

排他的 論理和 

論理和 



低 



式 は， 演算子の 優先 順に 実行され ます. 隣り あった 演算子の 優先順位が 同じ 場合， 式 は 左 か 
ら 右へ 評価され ます. カツ コを 用いれば， この 順序 を 変える ことができます • 
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例： 



4 + 2 * 3 
SEG 0001 ： 0002 
OFF 0001 ： 0002 
4+ (2 * 3) 
(4 + 2) * 3 



式の 値 



=10 (0AH) 

二 1 

=2 

=10 (0AH) 
=18 (12H) 



3.5 SYMDEB のコ マン ド 

本節で は， SYMDEB の コマンド を アルファ ぺッ ト 順に 解説し ます. 

SYMDEB の コマンド は， 1*2 文字の アルファ ぺッ ト とそれ に つづく い く つかの パラメータ 
の 形 をして います. パラメータに は 省略す る ことができる ものが あり， そのと き は， SYMDEB 
の 初期設定 値 や 直前に 行った コマンド の 結果の レ ジス タ 値が 用いられます. 
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Assemble 




m 脱 



A [く アドレス〉] 

8086/8087/8088/80186/80286/80287 の ニー モニ ッ 
リへ 直接 入れる 

Assemble コマンド は， 8086 / 8087 / 8088/186/286/287 ニー モニック をァ 
セン ブルして， その 結果の 命令 コード を， メモリの 指定され た アドレスに 入れ ま 
す. （286 の プロテクト モード は 除く） コマンド は， アドレスと 指定され たァ ドレ 
スの 命令 コード を 表示して， 次の 命令の ための プロンプト を 出します. アドレス 
を 入力 しないと， CS レジスタと IP レジスタの 現在 値に よって 与えられる ァ ドレ 
ス から ァ セン ブルが 開始 されます. 

命令 は， 標準の ニー モニックで 入力で きます. 新しい 命令 を アセンブル する 場 
合 は， 適切な ニー モニック を 入力して から リターン キー を 押します. SYMDEB 
は， 命令 を アセンブルして， 次に 使用可能な アセンブル を 表示し ます. ァ セン ブ 
ルを 終了 させて， SYMDEB プロンプトに 戻す 場合 は， リ ターン キーの み を 押し ま 
す. 

命令 ニー モニックの 入力に 関する 規則 を 次に 示します. 



1. WAIT や REP などの プレフィクス ニー モニック は， それら を 適用す る 命 
令の 前に 指定し ます. これら は， 別の 行に 分けて 入力し ます. 

2. FAR リターンの ための 二一 モニック は， RETF です. 

3. ストリング （文字列） の 操作に 関する ニー モニック は， ストリング サイズ 
を 明確に 指定し ます. た とえば， ワード 列 を 移動す る 場合に は MOVSW を 
用い， バイト 列 を 移動す る 場合 は， MOVSB を 使用し ます. 

4 . SYMDEB は， short, near, far の 飛び越 し （ジャンプ） や 呼び出 し （コー 
ル） を 自動的に 正しい アドレスに アセンブル します. これら は， NEAR ブ 
レフ イクス か FAR プ レフ ィ クスを 用いれば 無効に する ことができます. 
次に 例 をし めします. 



JMP 
JMP 
JMP 



502 

NEAR 

FAR 



505 
50A 



NEAR プレフィクス は， NE と 略す ことができます. ただし， FAR プレ 
フィ クスを 略す こと はでき ません. 
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5. SYMDEB では， ワードの 記憶 位置 を 表すの か， バイ トの 記憶 位置 を 表すの 
かわからない オペランド があります. この場合， プレフィクス "WORD 
PT 『か、、 BYTE PTR" を 用いて， データの 種類 を 明確に しなくて はな 
りません. 省略 語と して， "WCT と、、 BY" とが 使用で きます. つぎに 例 を 
示します. 

MOV WORD PTR [BP], 1 

MOV BYTE PTR [Sl-l], SYMBOL 

6- オペランドが 記憶 位置 を 示す のか， そのまま 値 オペランド を 示す のか 直接 
判断で きない ものが あります. SYMDEB では， 角 形 力 ッコで 囲まれた オペ 
ランド は， メモリ を 示す という 慣例 を 用いて います. つぎに 例 を 示します， 

MOV AX, 21 
MOV AX, [21] 

7. DB オペコード は， バイト 値 を メモリに 直接 アセンブル します. DW オペ 
コード は， ワード 値 を メモリに 直接 アセンブル します. つぎに 例 を 示し ま 
す. 

DB 1, 2, 3, 4, マ HIS IS AN EXAMPLE" 

DB THIS IS A QUOTE ゾ ' 

DB "THIS IS A QUOTE:'" 

DW 1000, 2000, 3000, "BACH" 

8. SYMDEB は， すべての 形式の レジスタ 間接 コマンド を サポートして いま 
す. つぎに 例 を 示します. 

ADD BX， 34 [BP+2] [Sl-l] 

POP [BP + DI] 

PUSH [SI] 

9. すべての 同義 オペコード も 同様に サポート しています. つぎに 例 を 示し ま 
す. 

LOOPZ 100 
LOOPE 100 

JA 200 

JNBE 200 
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10. 



8087 オペコード は， 明確に 指定し なくて はいけ ません. たとえば， WAIT 
は 8086 オペコード， FWAIT は 8087 オペコードです. また， 8087 ォ ペコー 
ドを 使用す る とき は， システムに 8087 数値 演算 プロセッサが 着装され てい 
る 必要が あります. つぎに 例 を 示します. 



FWAIT 
FADD 



ST, ST (3) 



入力に 誤り が あ る 場合, SYMDEB は， "Error" という メッセ 一 ジを 表示し, 
現在の アセンブル ァ ドレス を 再び 表示し ます， 



例 1 Assemble コマンドの 使用例 をつ ぎに 示します. 



A CS: 一 main 

この 例で は， で S:— main* によって 与えられる アドレスから アセンブルが 開 
始 されます. 



A 04BA ： 0100 

この 例で は， や 04BA: 0100" によって 与えられる アドレスから アセンブルが 開始 
されます， ノ 
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Breakpoint set 



「害 式， BP [n] く アドレス〉 [く 回数〉] 



「機 能 ブレーク ボイ ン ト の 作成 



Breakpoint Set コマンド は， 入力され た アドレスに 、、強力な" ブレーク ポィ 
ントを 作成し ます. プログラム 実行時に ブレーク ポイントに 達する と， プロ グラ 
ムは 停止して， SYMDEB はすべ ての レジスタと フラ グの 現在 値 を 表示 します. 強 
力な ブレーク ポィ ント は， Go コマンドが 作成す る ブレーク ポィ ントと 違って， 
Breakpoint Clear コマンド を 用いて 一時的に 無効に しない 限り， プログラム 内 
に 留まります. 

SYMDEB では， 強力な ブレーク ボイ ントを 10 個まで 用いる ことができます （0 
から 9).[n] は， 作成す る ブレーク ポイント 番号の 指定です. BP と n の 間に ス 
ペース （空白） を 入れて はいけ ません. n が 入力され ない 場合 は， 最初に 使用可能 
な ブレーク ポイント 番号が 使用され ます. 〈アドレス〉 は， 有効な 命令の アドレス 
(つまり 命令 オペコードの 最初の バイト） です. く 回数〉 は， ブレーク ポイントが 
採用され るまでに 無視され る 回数 を 指定し ます. 



例 



BP コマンドの 使用例 をつ ぎに 示します. 



BP main 



この 例で は， 強力な ブレーク ポイントが ma i n " に 作成され ています. 



BP8 add 



この 例で は， ブレーク ポイント 8 番が アドレス や add" に 作成され ます, 



BP 100 10 



この 例で は， ブレーク ボイ ント は， 現 CS セグメントの アドレス 100 に 作成され 
ます. この ブレーク ポイント は， 採用され るまでに 16 (10H) 回 無視され ます. 
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BreaKDoint Clear 



[害 式 I BC { く リスト〉 | *} 



ブレーク ポイントの 削除 



■ E 



例 



Breakpoint Clear コマンド は， 強力な ブレーク ポイント を プログラムから 取 
り 除きます. 〈リスト〉 を 入力す ると， そこに 挙げられ ている ブレーク ポイント を 
複数 削除し ます. リスト は， 0 から 9 の 整数 値の 組み合わせです. アスタリスク 
(*) を 指定す ると， すべての ブレーク ポイント を 取り除きます. 



BC コマンドの 使用例 をつ ぎに 示します. 



BC 0 4 8 



この 例で は， ブレーク ポイント 0, 4， 8 番が 取り除かれます. 



BC * 



この 例で は， すべての ブレーク ポイントが 取り除かれます， 
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Breakpoint Disable 





^1 


* 




1 解 





BD 



ス 卜〉 I ♦} 



ブレーク ポイントの 一時的な 無効 化 



Breakpoint Disable コマンド は， 強力な ブレーク ポイント を 無効に します • ブ 
レーク ポイント は 削除され る わけで はなく， Breakpoint Enable コマンド を 用い 
て， いつでも 復元で きます. -，' 

〈リスト〉 を 入力す ると， コマンド は， そこに 挙げられ ている 番号の ブレーク ポ 
イン トを 無効に します. く リスト〉 の 内容 は， 0 から 9 の 整数 値の 組み合わせです. 
アスタリスク （*) を 入力す ると， すべての ブレーク ポイント を 無効に します. 



停 |J 



BD コマンドの 使用例 をつ ぎに 示します. 



BD 0 4 8 



この 例で は， ブレーク ポイント 0, 4, 8 番が 無効になります， 



* 



この 例で は， すべての ブレーク ボイ ントが 無効になります. 
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Breakpoint Enable 



匚害 式] BE {< リスト〉 | *} 



ブレーク ポイントの 有効 化 



Breakpoint Enable コマンド は， Breakpoint Disable コマンド によ つて 一時 
的に 無効と なった 強力な ブレーク ボイ ン ト を 有効 化 （復元） します. 

く リスト〉 を 入力す ると， そこに 挙げられ ている 複数の ブレーク ボイ ントの 有効 
化 を 行います. リスト は， 0 から 9 の 整数 値の 組み合わせです. アスア リスク （*) 
を 入力す ると， すべての ブレーク ポイントが 有効 化されます. 



BE コマンドの 使用例 をつ ぎに 示します. 



BE 0 4 8 



この 例で は， ブレーク ポイント 0, 4, 8 番が 有効 化されます, 



BE * 



この 例で は， すべての ブレーク ポイントが 有効 化されます. 
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Breakpoint List 





ま 






m 


脱 



BL 



ブレーク ポイントの リスト 



Breakpoint List コ マン ドは， Breakpoint コマンドが 作成す るすべ ての ブレー 
ク ポイント に関する 現在の 情報 を リストアップ します. コマンド は， ブレーク ポ 
イン ト 番号， 有効 化 ノ 無効 化の 状態， ブレーク ポイントの アドレス， 〈回数〉 の 残 
り 数， く 回数〉 の 設定 値 （カツ コ内） を 表示し ます. 

ブレーク ボイ ントが 設定され ていなければ， リ ス ト は 何も 表示され ません， 

BL コマンドの 使用例 をつ ぎに 示します. 



このように 入力す ると， ブレーク ポイントの 状況が 表示され ます. 表示 はつぎ 
のようになります. 

0 e 04BA ： 0100 

4 d 04BA ： 0503 4 (10) 

8 e 0D2D ： 0001 3 (3) 

この 例で は， ブレーク ポイント 0 と 8 は 有効 化 （e) されて いて， ブレーク ボイ 
ン ト 4 は 無効 化 （d) されて います. ブレーク ポイント 4 のく 回数〉 の 設定 は 10 で， 
あと 4 回の 残り 回数が あります. ブレーク ポイント 8 の 最初の パス 数 は 3 で， そ 
の 3 つの く 回数〉 をす ベて 残して います. ブレーク ボイ ン ト 0 に は， 最初の く 回 
数〉 が あり ません 力 5 , これ は 1 にセッ ト された という ことです. 
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Comment 



： m — «T 



* 



卜〉 



r^rw\ 注釈 文 （コメント） の 表示 



Comment コマンド は， アスタリスク （*) に つづいて タイプした 文字 をスク 
リーンな どの 出力装置に エコーバック します. この コマンド は， Redirection (入 
出力の 切り替え） コマンドと 組み合わせて 用いる と 便利で， デバッグ 作業の 流れ 
(経過 • 工程） を 記録と して 残して おきたい ときな どに 役立ちます. 



ゆ J 



comment 



ドの 使用例 をつ ぎに 示します • 



- R CX 80 

- * Change the count in CX to 80 
Change the count in CX to 80 
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Compare 



書 式 j C 〈レンジ〉 く アドレス〉 



メモリ 内容の 比較 ノ 

Compare コマンド は， く レンジ〉 が 指定す る 範囲の メモリの バイトと， くァ ドレ 
ス〉 から 始まる それに 対応す る メモリの バイ ト を比铰 します. 対応す る バイ 卜が 
すべて 一致し た と き は， SYMDEB は プロンプト を 表示 して， 次の コマンド を 待ち 
ます. 対応す る バイ 卜が 一致し ない 場合 は， その 不一致の バイ 卜が 表示され ます， 



c 



ドの 使用例 をつ ぎに 示します. 



C 100， IFF 300 



し 



の 例で は， メモリの 100H 番地から 1FFH 番地までの ブロック 力；， メモリの 
300H 番地 か ら 3FFH 番地までの ブロックと 比較され ます. 



C 100 L 100 



300 



この 例で は， メモリの 100H 番地から 256 (100H) バイト 目まで が， 300H 番地 
から 256 バイ ト 目までと 比較され ます. 
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お 3 な SYMDEB ： シ ン ボ リ ッ クゲ ペッ グ ユー マソ リテノ 



Display 

[T^l ？ く 式〉 

I 機 能 I く 式〉 の 値の 表示 

I 解 脱 I Display コマンド は， 入力され たく 式〉 の 値 を 表示し ます. コマンド は， 式 を 評 

価して から， 様々 な 形式で その 値 を 表示し ます. 形式に は， 完全 アドレス 16 ビッ 
ト 16 進数， 32 ビット 16 進数， 10 進数 （カツ コで 囲まれて いる）， ストリング 値 
(ダブル コー テーシ ヨンで 囲まれて いる） があります. 

く 式〉 は， 数， シンボル， アドレス および 演算子 を 組み合わせた ものです. 演算 
子に ついては， この 章で 述べた や 式" の 項 を 参照して ください. 

I 例 I ？ (Display) コマンドの 使用例 をつ ぎに 示します. 

？ 3*4 

この 例で は， 式 、、3 * 4" の 値が 表示され ます. 
？ DS: table 

この 例で は， シンボル アドレス ADS:table" の 値が 表示され ます. 
？ WO DGROUP: 一 bufsiz 

この 例で は， シンボル アドレス や DGROUP ： 一 bufsiz" の ワードが 表示され ま 
す. 
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3.5 SYMDEB の コマンド 



Dump ascii 



「書 式 I DA [く アドレス〉 I く レンジ〉】 

[機 能 I メモリ 内容の ASCII ダンプ 1 ■：■ 

「解 説 1 Dump Ascii コマンド は， 指定され たく アドレス〉 またはく レンジ〉 の メモリ 

の 内容 を ASCII 文字で 表示 します. コマンド は， 入力す る アドレス または レンジ 
によって， 1 行 または 複数 行の 文字 を 表示し ます. キャリッジ リターン や ライン 
. フィード などの 印字で きない コード は， ピリオド （.） で 表示され ます. 

く アドレス〉 を 入力す ると， 最初の 、、(T バイ 卜に あたる まで， または 128 バイ 
トを 表示し きる まで， ASCII 文字 を 表示し 続けます. 

〈レンジ〉 を 入力す ると， コマンド は， その 範囲が 終わる まで， ASCII 文字の 表 
示 を 続けます. アドレス も レンジ も 入力され ない 場合， コマンド は 最初の や (T バ 
ィ 卜までの すべての 文字す るか， または 128 バイ トを 表示して しまうまで， ASCII 
文字の 表示 を 行います. この 表示 は， 前回に 表示され た 最終 バイトの 直後の アド 
レスで ある 現 ダン プア ドレスから 始ま ります. 

1 例 I DA コマンドの 使用例 をつ ぎに 示します. 

DA CS ： 100 100 

この 例で は， X:S:10(T から" CS ： 110" までの バイ トの ASCII 値が 表示され 
ます. 表示 はつぎの ようになります. 

04BA ： 0100 A STRING. . Text. . 

このように， 印字で きない コード は ピリオド （•） で 表示され ます. 
DA 

こ の 例で は， 現 ダンプ アドレス の 文字が 表示 されます. たとえ ば， 前回の Dump 
Ascii コマンド での « 終 バイ ト が 04BA ： 0110 であ つ た 場合， この コマンド では， 
04BA:0111 から バイ 卜の 表示が 開始され ます. 

DA name 

この 例で は， シンボル アドレス 、、！ i am ビ の 文字が 表示され ます. 
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笫 3 章 SYMDEB: シンボリック デバッグ ユーティリティ 



Duitid Bytes 



害 式， DB [く アドレス〉 | く レンジ〉] 



メモリ 内容の バイト 単位の 16 進と， ASCII ダンプ 



CM 



Dump Byte コマンド は， 入力され た 〈アドレス〉 またはく レンジ〉 の メモリ 
内容 を 16 進 値と ASCII 値で 表示し ます. 入力す る 〈アドレス〉 または 〈レンジ〉 
によって， コマンド は， 1 行 または 複数 行の 表示 を 行います. 各行に は， その 行 
の 先頭 バイトの アドレスが 表示され， それに 続いて， 最大 16 個の 16 進 バイト 値 
が 表示され ます. バイト 値の 直後に， 対応す る ASCII 値が 続きます. 16 進 値 は， 
ハイフン （-) で 区切られる 8 番目の 値と 9 番目の 値 以外 は， スペースで ピリ ォ ド 
られ ます. ASCII 値 は， 区切らないで 印字され ます. 印字で きない ASCII 値 は， 
( ) で 示されます. コマンド は， レンジが 終わる まで， または 最初の 128 バイト 
が 表示され るまで， 値と 文字の 表示 を 行います. 



DB コマンドの 使用例 をつ ぎに 示します. 



DB CS ： 100 



この 例で は， 、、CS:100〃 から 、、110" までの バイ ト 値が 表示され ます. 表示 は， 
つぎのようになります. 

04BA:0100 41 20 73 74 72 69 6E 67-04 01 05 54 65 78 74 0D A strir^.Tect. 
04BA :01100A 

このように ASCII 文字 は， 右側に 示されます • 



この 例で は， 現 ダンプ アドレスに つづく 128 バイ 卜が 表示され ます • たとえば， 
前回の Dump コマンドの 際の 最終 バイ トが ^04BA:011(T であった 場合， この コ 
マンドで は A()4BA:011 ビ から バイ トの 表示が 開始され ます. 

DB ね ble table + 5 



この 例で は， シンボル アドレス "table なから 始まる 6 バイ トが 表示され ます, 
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3.5 SYMDEB の コマンド 



Dump Words 





式 1 


機 


能 




ft? 





直 



DW [く アドレス〉 I く レンジ〉] - 
メモリ 内容の ワード （2 バイト） 単位の 16 進 ダンプ 

Dump Words コマンド は， 入力され た く アドレス〉， または 〈レンジ〉 のヮー 
ド （2 バイト 値） の 16 進 値 を 表示し ます. 入力す る アドレス または レンジに よつ 
て， コマンドが 1 行 または 複数 行 を 表示し ます. 

各行に は， その 行の先頭 ワードの アドレスが 表示され， 続いて 最大 8 個の 16 進 
ワード 値が 表示され ます. 16 進 値 は， スペース によって 区切られます. コマンド 
は， レンジの 終わりまで， または 最初の 64 ワードが 表示され るまで 値の 表示 を 行 
います， 

DW コマンドの 使用例 をつ ぎに 示します. 
DW CS ： 100 110 

この 例で は， 、、CS: 100 "から、、 CS: 110 "までの ワード 値が 表示され ます. 表示 

はつぎの ようになります. 

04BA:0100 2041 7473 6972 676E 0104 5405 7865 0A0D 
04BA:0110 002E 

1 行に つき 8 個より 多くの 値 は 表示され ません. 



DW 



この 例で は， 現 ダンプ アドレスの 64 ワードが 表示され ます. たとえば， 前回の 
Dump コマンドの 際の 最終 バイ 卜が、、 04BA: 0110 "であった 場合， この コマンド 
では， 、、04BA:01ir' から ワードの 表示が 開始され ます. 

DW table table + 5 



この 例で は， シンボル アドレス "table" から 、、table+5" までの レンジの ヮ一 
ドが 表示され ます. 
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第 3 章 SYMDEB: シンボリック デバッグ ユーティリティ 



Dump Doublewords 



害 


式 




機 


能 









仔リ 



DD [く アドレス〉 | く レンジ〉] - 

メモリ 内容の 倍 長 ワード （4 バイト） 単位の ダンプ 

Dump Doublewords コマンド は， 入力され た く アドレス〉 または く レンジ〉 
の 倍 長 ワード （4 バイ ト値） の 16 進 値 を 表示し ます. 入力す る アドレス または レ 
ンジ によって， コマンド は 1 行から 複数 行 を 表示し ます. 各行に は， その 行の 最 
初の 倍 長 ワードの アドレス が 表示 され, 統 いて 最大 4 個の 16 進 倍 長 ワード 値が 表 
示されます. 各 16 進 値 は， スペースで 区切られます. コマンド は， レンジが 終わ 
るまで， または 最初の 32 個の 倍 長 ワード を 表示し ます. 

DD コマンドの 使用例 をつ ぎに 示します. 
DD CS.100 110 

この 例で は， 、、CS:100 "から、、 CS:11(T までの 倍 長 ワードが 表示され ます. 表 
示 はつぎの ようになります. 

04BA:0100 7473:2041 676E ： 6972 5054:0104 0A0D ： 7865 
04BA:0110 0000 ： 002E 

1 行に つき， 4 個より 多くの 値 は 表示され ません. 

DD 

この 例で は， 現 ダンプ アドレスの 32 個の 倍 長 ワード が 表示 されます. たとえ ば， 
前回の Dump コマンドの 最終 バイ 卜が 04BA: 0110 であった 場合， この コマンド 
では， 04BA:0111 から 倍 長 ワードの 表示が 開始され ます. 

DD table table + 5 

この 例で は， シンボル アドレス や tabl ビ' からな table+5 グ までの レンジの 倍 長 
ワードが 表示され ます • 
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3.5 SYMDEB の コマンド 



Dump Short reals 



「害 式 I DS [く アドレス〉 I く レンジ〉] ：： i. 

I 機 能 I 短い （4 バイ ト） の 浮動小数点 数の 表示 ， 

「解 説つ Dump Short reals コマンド は， 入力され た レンジの 短い （4 バイ ト） 浮動 小数 

点数の 16 進 値と 10 進 値 を 表示し ます. 入力す る アドレス または レンジに よって， 
コマンドが 1 行 または 複数 行 を 表示し ます. 各行に は， 短い 実数の アドレスが 表 
示され， 次に その 数の パイ 卜の 16 進 値， その 数の 10 進 値が 統 きます. 16 進 値 は， 
スペースで 区切られます. 10 進 値の 形式 は， つぎのと おりです. 

土 . dd...dE 土 mm 

表示 を 行う 場合, SYMDEB は 表示 を 行う 前に， 短い 実数 を 長い 実数に 変換し ま 
す. そのため， 最大 16 個の 10 進数 を 表示し ますが， 最初の 7 個の 数字の みが 有 
効です • 

コマンド は， 最低 1 個の 値 を 表示し ます. レンジ を 入力す ると， コマンド は そ 
の レン ジ 内の すべての 値を 表示 します. 

I 例 I DS コマンドの 使用例 をつ ぎに 示します. 

DS ds ： 100 

この 例で は， アドレス、、 ds: 100" の 短い 実数が 表示され ます. 表示 はつぎの よ 
うになります. 

04BA ： 0100 00 00 20 40 +. 25E + 1 

このように， 1 行に つき 1 個の 値 だけが 表示され ます. 
DS pi 

この 例で は， シンボル アドレス 、、 p i" の 短い 実数が 表示され ます. 
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第 3 章 SYMDEB: シンボリック デバッグ ユーティリティ 



Dump LoriR reals 



「書 式 1 DL [く アドレス〉 I く レンジ〉] 



機 能 長い （8 バイ 卜） の 実数の 表示 



Dump Long reals コマンド は， 入力され た レンジの 長い （8 バイ ト） 浮動 小数 
点数の 16 進 値と 10 進 値 を 表示し ます. 入力す る く アドレス〉 または 〈レンジ〉 
によって， コマンドが 1 行 または 複数 行 を 表示し ます. 

各行に は ， 浮動小数点 数の アドレスが 表示され， 次に その 数の バイトの 16 進 値, 
その 数の 10 進 値が 統 きます. 16 進 値 は， スペースで 区切られます. 10 進 値の 形 
式 は， つぎのと おりです. 

土 • dd..dE 土 mm 



最高 16 個の 10 進数が 表示され ます. 

コマンド は， 最低 1 個の 値 を 表示し ます. く レンジ〉 を 入力す ると， その 範囲 内 
のす ベての 値 を 表示し ます. 



!_] DL コマンドの 使用例 をつ ぎに 示します. 



DL ds: 100 



この 例で は， アドレス、、 ds:10(T の 長い 実数が 表示され ます， 表示 はつぎの よ 
うになります. 



04BA: 0100 86 37 6B FO BE 2A 57 3F +.14139993273678774E 一 2 

このように， 1 行に つき 1 個の 値 だけが 表示され ます. 
DL gamma 

この 例で は， シンボル ァ ドレス、、 gamma 々の 長い 浮動小数点 数が 表示され ます， 



3.5 SYMDEB の コマンド 



Dump Ten-byte reals 



害 


式 




機 





DT [くァ ドレス〉 I く レンジ〉] 

10 バイ 卜の 長い 浮動小数点 数の 表示 

Dump Ten-byte reals コマンド は， 入力され た 〈アドレス〉 またはく レンジ〉 
の 10 バイ 卜の 浮動小数点 数の 16 進 値と 10 進 値 を 表示し ます. 

入力す る アドレス または レンジに よって， コマンドが 1 行か 複数 行 を 表示し ま 
す. 各行に は， 浮動小数点 数の アドレスが 表示され， 次に その 数の バイ 卜の 16 進 
値， 10 進 値が 続きます. 16 進 値 は， スペースで 区切られます. 10 進 値の 形式 はつ 
ぎのと おりです， 

土. dd. . . dE 土 mm 

最大 16 個の 10 進数が 表示 されます. 



コマンド は， 最低 1 個の 値 を 表示し ます • レンジ を 入力す ると， コマンド は そ 
の 範囲 内の すべての 値 を 表示し ます. 

DT ds: 



この 例で は， アドレス 、、ds:10(T の 浮動小数点 数が 表示され ます. . 表示 はつぎ 
のようになります. 

04BA:0100 86 37 6B FO BE 2A 57 3F 00 00 +.14139993273678774E-2 

このように 1 行に つき 1 個の 数 だけが 表示され ます • • 



DT gamma 



この 例で は， シンボル アドレス "gamma クの 10 バイ 卜の 浮動小数点が 表示され 
ます， 
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第 3$ SYMDEB: シンボリック デバッグ ユーティリティ 



Duitid 



書 式 | D [く アドレス〉 | く レンジ〉】 



メモリ 内容の 16 進と ASCII ダンプ 



Dump コマンド は， 入力され た 〈アドレス〉 または 〈レンジ〉 の メモリの 内容 
を 表示し ます. この コマンド は， 直前に 用いた DA コマンド， DS コマンド， DL 
コマンド， DT コマンドの 定義す る 形式と 同じ 形式で メモリ を 表示し ます. 

入力す る アドレス または レンジに よって， コマンド は 1 行か 複数 行 を 表示し ま 
す. 各行に は， 最初に 表示され る 項目の アドレスが 表示され ます. コマンド は， 
最低 1 個の 値 を 表示し ます. レンジ を 入力す ると， コマンド は レンジ 内の すべて 
の 値 を 表示し ます. アドレス や レンジ を 入力 しないと， コマンド は， 最後に 表示 
された バイ トの 次の バイ 卜の メモリの 内容 を 表示し ます. 



注意 

Dump コマンドの 名前 は， 最低 1 つの スペースで， く アドレス〉 値 またはく リス 
ト〉 値と 区切らなければ なりません. 



自 



D コマンドの 使用例 をつ ぎに 示します. 



DA ds: 100 

04BA: 0100 A string.. 

D 

04BA:010B Text... 
この 例で は， Dump コマンド は， Dump Ascii コマンドで 表示され た 列の 直後 



の アドレスの ASCII 文字 を 表示し ます. 



DW ds: 100 101 
04BA:0100 2041 
D ds:324 325 
04BA ： 0324 FE31 
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3.5 SYMDEB の コマンド 

この 例で は， Dump コマンド は， アドレス、、 ds:324 クの ワード を 表示し ます • 
DS pi 

04BA ： 0100 00 00 20 40 +.25E + 1 . 
D gamma 

04BA ： 0104 00 00 20 40 +.25E +1 

この 例で は， Dump コマンド は， シンボル アドレス^) 广の 短い 実数 を 表示し ま 
す • 
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Enter 



rr e く アドレス〉 [く リスト〉] 
I 機 能 I メモリへ バイト 値 を 入れる 

I 解 脱 I Enter コマンド は， 1 個 または 複数の バイ ト値を メモリの 指定され た アドレス 

に 入れます. く リスト〉 を 入力す ると， コマンド は， リスト 中の すべての 値 を 使つ 
て しまうまで， 入力され た アドレスの バイトと， それに 続く アドレスの バイトの 
E 換を 行います. 〈リス ト〉 を 省略した とき は， コマンド は， バイ ト値を 促します. 

エラーが 起きた 場合， すべての バイト 値 は， もとの ままに なって います. 

く リス ト〉 を 入力 しないと， SYMDEB は， アドレス とその 現在 値と ピリオド し） 
を 表示して， その アドレスの 新しい 値の 入力 を 求めます. そこで， つぎに 示す 方 
法 を 用いて， バイト 値 を B き 換えたり， 次の アドレスに 進んだり， また 前の アド 
レスに 戻ったり， コマンド を 終了した りする ことができます. 

1. バイト 値 を! S き 換える とき は， 現在の 値の 次に 新しい 値 を タイプし ます. 
入力が 16 進数で 1 桁 か 2 桁で あ る こと を 確認して ください. コマンド は， 
それ以上の 余分な 数字 や 文字 を 無視し ます. 

2. 次の バイト （アドレス） へ 進む 場合に は， スペース キー を 押します. いつ 
たん 次の バイトへ 進む と， その 値 を 変更したり， さらに 次の バイトへ 進む 
ことができます. 8 バイ 卜の 境界 を 越えて 飛び越す と， SYMDEB は 新しい 
アドレスと 値 を 表示して， 新しい 表示 行 を 開始させます. 

3. 前の バイ ト （アドレス） へ 戻る 場合 は， ハイフン （-) を タイプし ます. 前 
の バイ 卜に 戻す と， SYMDEB は， その バイ 卜の アドレスと 値 を 用いて， 新 
しい 表示 行 を 開始させます. 

4. E コマンド を 終了 するとき は， リ ターン キー を 押します. コマンドの 終了 は 
いつでも 行う ことができます. 

I 例 I E コマンドの 使用例 をつ ぎに 示します. 

E CS ： 100 1 2 B E5 

この 例で は， 。5:100と1， じ5:101と2 8, CS:102 と E5 の 各々 の 間で， バ 
ィ 卜の K 換が 行われます. 
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3.5 SYMDEB の コマンド 

E ES ： 100 

こ の 例で は， SYMDEB がつ ぎの ような プロンプト を 表示し ます， 

04BA ： 0100 EB. 
ここで， 41 と タイプす ると， 値 EB を 新しい 値 41(H) に 変更で きます. 

04BA ： 0100 EB.41 

スペース キー を 押す と， 次の バイトへ 進みます. 

04BA ： 0100 EB.41 10: 

ハイフン を タイプす ると， 前の 値へ と 戻る ことができます. 

04BA ： 0100 EB.41 10:- 
04BA ： 0100 41. 



71 



553 章 SYMDEB: シンボリック デバッグ ユーティリティ 



Enter Bytes 



式， eb く アドレス〉 [く リスト〉] 
I 機 能 I 指定した アドレス〜 く イト 値 を 入れる. 

「解 ^1 Enter Bytes コマンド は， 1 つまた は 複数の バイ ト値を メモリに 収めます. 才ブ 

シ ヨンの く リスト〉 に 複数の バイト 値が 指定され ている とき は， その 中の 値が 
く アドレス〉 から 始まる メモリに 連統 して 収められます. 

く リスト〉 をつ けずに， アドレス だけが 指定され たと き は， アドレス とその メモ 
リの 現在の バイ ト^と ピリオド （•） が 表示され ます （前項， E コマンド 同様). ユー 
ザ 一は この 時点で， メモリに 新しい バイト 値 を 入れる， 前後の アドレス （バイト） 
に 移るな どの 操作 を 行う ことができます. 

• 表示され ている バイト 値 を 変更 するとき は， その 値 を タイプし ます. ピリ 

ォドの 右側に 入力した バイ ト 値が 表示され ます. 
• 次の バイ ト値 （ァ ドレス） に 進む と き は， スペース キー を 押します. 

SYMDEB は， スク リーンの 1 行に 8 バイ ト ずつ 表示 を 行い， アドレスが 8 

バイ ト分 以上 進む と， 新しい 行に その 行の先頭 アドレスと バイ ト値を 表示 

します， 

• 前の アドレスに 戻る とき は， ハイフン （-) を タイプし ます. 新しい 行に， 

その バイトの アドレスと， 現在 値が 表示され ます. 
• EB コマンド を 終了して， SYMDEB の プロンプトに 戻る とき は， リターン 

キー を 押します. 

• 〈リスト〉 で， ストリングス （引用符で 囲まれた 文字） が 指定され ると， 前 
項の EA コマンドと 同様に， 文字 （文字列） の ASCII コード 値が 収められ 
ます. 

1 例 I EB コマンドの 使用例 をつ ぎに 示します， 

-EB CS ： 100 01 2 B E5 

この 例 は， CS ： 100 番地から 始まる 3 バイ ト （CS:100, CS ： 101, CS ： 102) 
に， 新しい バイ ト値， "01"， "2 B\ や を 入れた ものです. 

-EB CS ： 100 
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3.5 SYMDEB の コマンド 

2344:0100 F3. 

この 例 は， アドレス だけ を 指定した 場合の ものです. SYMDEB は， アドレス 
'2344:0100" とその メモリの 現在の 値 や F 3" を 表示し ます. 
この 値 を 、、5E〃 に 変更 するとき は， 新しい 値 を タイプし ます. 

-EB CS ： 100 
2344:0100 F3.5e 

次の バイト 値に 進む とき は， スペース キー を 押します. 

-EB CS ： 100 

2344:0100 F3.5e 10. 

ここに も 新しい バイ ト値 、、76〃 を タイプし ます. 
-EB CS ： 100 

2344:0100 F3.5e 10.76 B0. 

先に 入力した 値 *76〃 は 間違いで， 正しく は や 77〃 であった とします. 前の ァ 
ドレスに 戻る とき は， ハイフン を タイプし ます. 

- EB CS ： 100 

2344:0100 F3.5e 10.76 B0.- 
2344:0101 76. 

正しい 値 を 入力し なおします. 
-EB CS ： 100 

2344:0100 F3.5e 10.76 B0.- 
2344:0101 76.77 

必要な 入力が 済んで， EB コマンド を 終了 するとき は， リターン キー を 押し ま 
す. 

•EB CS ： 100 

2344 ： 0100 F3.5e 10.76 B0.- 
2344:0101 76.77 

SYMDEB の プロンプトが 表示され， つぎの SYMDEB コマンド を 入力で きる 
ようになります， 
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第 3 章 SYMDEB: シンボリック デバッグ ユーティリティ 



Enter ascii 







機 





EA く アドレス〉 [く リスト〉] 

指定 し たァ ド レスへ リスト 中の 文字の ASCII コー ド値を 入れる， 

Enter Ascii コマンド は， 事項で 解説す る EB コ マン ドと 同一の 働き をし ま 
す. く リスト〉 中の 文字 （文字列） の ASCII コ一ド 値が 指定した アドレスから 始ま 
る メモリに 収められます. 



「例"! EA コマンドの 使用例 をつ ぎに 示します. 

-EA data— seg ： msg2 、、Can't open file 



この 例で は， 文字列、、 Can't open file" の ASCII コードの 値が， ァ ドレス、、 data 



seg ： msg2" 以降に 収められます， 
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3.5 SYMDEB の コマンド 



Enter Words 




「書 式"! EW く アドレス〉 [く 健〉] ' 

I 機 能 I 指定した アドレスへ， ワード 値 を 入れる ， 

「解 説 1 Enter Words コマンド は， 指定した アドレスの メモリへ， ワード 値 (2 バイト） 

を 収めます. 〈値〉 で 指定で きる 値 は， 1 问に 1 ワード 分です. 

く 値〉 をつ けずに， アドレス だけが 指定され ると， SYMDEB は， その アドレス 
から 始まる 1 ヮー ド （2 バイ ト） 分の メモリの 現在の 値 を 表示し， ユーザーの 入力 
を 待ちます. 

〈値〉 を 指定した とき は， その アドレスの 1 ワード を 変更し， つづいて 次の アド 
レスと その ワード 値 を 表示して， ユーザーの 入力 を 待ちます. 

EW コマンド を 終了して， SYMDEB の コマンド 入力 モードに 戻る とき は， リ 
ターン キー を 押します. .， 

1 例 I EW コマンドの 使用例 をつ ぎに 示します. 



この 例 は， アドレス "CS:400 "の 1 ワード （0400 と 0401) に ワード 値 ME 3 
A か を 入れる ものです. EW コマンド は， この ワードに 新しい ワード 値 を 収め， つ 
づ いて 次の アドレス 、、2344:0402" とその 内容、、 ED32〃 を 表示し ます. この 例で 
は， この 新しい ワードに *8ad8~ を 入れて います. EW コマンド は， さらに 次の 
アドレス とその ヮー ド値を 表示して います. このような 状態で リ ターン キ 一を 押 
すと， EW コマンド は 終了し， SYMDEB の コマンド 入力 モードに 戾 ります. 



-EW CS ： 400 4e3a 



2344 ： 0402 



E D 3 2 . 8 ad 8 



2344 ： 0404 



1D3C. 
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章 SYMDEB: シンボリック デバッグ ユーティリティ 



Enter Doublewords 



LJt 


^1 


ED く アドレス〉 [く 值〉] 






« 




指定した アドレスへ， 2 ヮ 


一 ド値を 入れる 




「解 




Enter Doublewords コ 一、 


？ンド は， 指定した アド レジ 


くへ， 2 ワード （4 バイ ト） の 



値 を 入れます. く 値〉 で 指定で きる 値 は， 1 回に 2 ワード 分です. 



〈値〉 をつ けずに. アドレス だけ を 指定す ると， ED コマンド は， その アドレス 
と 現在の メモリ 値 を 表示して， ユーザーの 入力 を 待ちます. 
く 値〉 を 指定す ると， 指定した アドレスに 2 ワード 値 を 収めて， 統 きの アドレス 

とその 現在 値 を 表示し， ユーザーの 入力 を 待ちます. 
ED コマンド を 終了して， SYMDEB の コマンド 入力 モードに 戻る とき は， リ 

- ターン キー を 押します. 

I 例 I ED コマンドの 使用例 をつ ぎに 示します. 

-ED CS ： 100 12 EF ： CD 01 
2344:0104 440 E ： 1234 . 1234 ： 5678 

2344:0108 8 ED9: 1234 

この 例 は， 、、CS:100" から 始まる 2 ワードに や 12EF:CD0r を 入れる もので 
す. ED コマンド は， この 値 を 入れた 後， 統 きの アドレス、、 2344:0104〃 とその 現 
在 値、、 440 E ： 1234" を 表示し ます. ユーザー は つづいて 2 ワード 値 や 1234: 5678" 
を 入力して います. ED コマンド は， さらに 統 きの ァ ドレスと 2 ワード 値 を 表示し 
ます. このような 状態で， リターン キー を 押す と， SYMDEB の コマンド 入力 モー 
ドに 戻ります. 、 



3.5 SYMDEB の コマンド 

Enter Short reals 



「書 式， ES く アドレス〉 [く 值〉] ― 
i 機 能 I 指定した アドレスへ， 短い 実数 （4 バイト） を 入れる 



機 舵 I 



Enter Short reals コマンド は， 指定した アドレスへ 4 バイ ト 形式の 浮動 小数 
点 値 （実数） を 入れます. く 値〉 で 指定で きる 短い 実数 は， 1 回に 1 個です. 

く 値〉 をつ けずに アドレス だけ を 指定す ると， ES コマンド は， その アドレス か 
ら 始まる 4 バイ ト 分の メモリの 現在 値 を 浮動小数点 表示で 示し， ユーザーの 入力 
を 待ちます. 

く 値〉 を 指定す ると， ES コマンド は， 指定され た アドレス （4 バイト 分） の 内容 
を 変更し， 続いて 次の アドレス とその 現在 値 を 表示し， ユーザーの 入力 を 待ち ま 
す. 

ES コマンド を 終了して， SYMDEB の コマンド 入力 モードに 戻る とき は， リ 
ターン キー を 押します. 

ES コマンドの 使用例 をつ ぎに 示します. 



-ES pi 3.1415926 



• この 例 は， シンボリック アドレス、、 pi" へ， 3.1415926 という 数値 を 短い 実数の 
形式で 入れた ものです. ES コマンドで， アドレス だけ を 指定した 場合 は， つぎの 
ようになります. 



- ES pi 
210 C: 0130 
210 C: 0134 



-0 ! . 1256210825216 E + 16 



+ 0 , 31415926 e + 1 



ES コマンドで 入れた 値 を 調べる に は， DS コマンド を 用います. 先頭 バイ 卜の 
アドレス， 4 バイ トの 内容， 浮動小数点 形式で 表示した 10 進数の 数値が 表示され 
ます. この 数値 は， 16 桁で 表示され ますが， 有効数字 は 小数点 以下 7 桁までで， 
後ろの 9 桁 は 意味 を 持ちません. 

-DS pi , 

210 C ： 0130 DA OF 49 40 + 0 • 3141592502593994 E + 1 
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第 3 章 SYMDEB: シンボリック デバッグ ユーティリティ 



Enter Long reals 



G EL く アドレス〉 [く 值〉] 



機^] 



指定した アドレスへ， 長い 実数 （4 バイト） を 入れる. 

. 、 Enter Long reals コマンド は， 指定した アドレスへ 8 バイ ト 形式の 浮動 小数 
^ 点 値 （実数） を 入れます. 〈値〉 で 指定で きる 長い 実数 は， 1 回に 1 個です. 

〈値〉 をつ けずに アドレス だけ を 指定す ると， EL コマンド は， その アドレス か 

ら 始まる 8 バイ ト 分の メモリの 現在 値 を 浮動小数点 表示で 示し， ユーザーの 入力 

を 待ちます. 

く 値〉 を 指定す ると， EL コマンド は， 指定され た アドレス （8 バイト 分） の 内容 
を 変更し， 絞いて 次の アドレス とその 現在 値 を 表示し， ユーザーの 入力 を 待ち ま 
す. 

EL コマンド を 終了して， SYMDEB の コマンド 入力 モードに 戻る とき は， リ 
ターン キー を 押します. 



「例， EL コマンドの 使用例 をつ ぎに 示します. 



-EL pi 3. 141592653589793 



• この 例 は， シンボリック アドレス、、 pi" に， 数値、、 3 .141592653589793 なを 長い 
実数の 形式で 入れた ものです. EL コマンドで， アドレス だけ を 指定した 場合 は， 
つぎのようになります. 



-EL 170 

、-. 210 C: 0170 +0.1343280735843091 E+65299 +0.3141592653589793 e+1 



210 C: 0178 +0.1040230032441619 E-71 
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3.5 SYMDEB の コマンド 



Enter i en-byte reals 



I 害 式 1 ET く アドレス〉 [く 値〉] 

I 機 能 I 指定した アドレスへ， 10 バイト 実数 を 入れる < 

I 機 能 I Enter Ten-byte reals コマンド は， 指定した アドレスへ 10 バイ 卜 形式の 浮動 

小数点 値 （実数） を 入れます. く 値〉 で 指定で きる 短い 実数 は， 1 回に 1 個です. 

〈値〉 をつ けずに アドレス だけ を 指定す ると， ET コマンド は， その アドレス か 
ら 始まる 10 バイ ト 分の メモリの 現在 値 を 浮動小数点 表示で 示し， ユーザーの 入力 
を 待ちます. 

〈値〉 を 指定す ると， ET コマンド は， 指定され た アドレス （10 バイト 分） の 内 
容を 変更し， 続いて 次の アドレス とその 現在 値 を 表示し， ユーザーの 入力 を 待ち 
ます. 

ET コマンド を 終了して， SYMDEB の コマンド 入力 モードに 戻る とき は， リ 
ターン キー を 押します. 

I 例 I ET コマンドの 使用例 をつ ぎに 示します. 

-ET pi 3.141592653589793 

こ の 例 は， シ ン ボ リック アドレス "pi" へ， 数値 、、3 . 141592653589793" を 入れ 
たもので す. ET コマンドで， アドレス だけ を 指定した 場合 は， つぎの ようになり 
ます. 

-ET pi 

210 C ： 0150 +0.0204654128113587 E+7898 +0.314152653589793 e+1 
210 C ： 015A +0.5976239733286124 E+3896 
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第 3 章 SYMDEB: シンボリック デバッグ ユーティリティ 



eXamine symbol map 



解 脱 



X [*] 

X？ [〈マップ 名〉 ！] [く セグメント 名〉：] [く シンボル 名〉] 



機 能 1 シンボル 名 と アドレスの リスト 表示 



eXamine symbol map コマンド は， 現 シンボル マップ 内の シンボルの 名前と 
アドレス を 表示 します. SYMDEB は， SYMDEB コ マン ド 行に 入力 さ れ た各シ ン 
ボル ファイル 名に 対して， シンボル マップ を 作成し ます. そこで， eXamine sym- 
bol map を 用いて， マップの 内容 を 調べる ことができます. 

X コ マン ドは， 現 シンボル マップと その マップ 内の セグメ ントの 名前 及び ロー 
ド セグメント アドレス を 表示し ます • アスタリスク （*) を 指定す ると， コ マン 
ド はすべ ての シンボル マップの 名前と ロー ド セグメント ァ ドレス を 表示し ます. 

X？ コ マン ドは， シンボル マップ 内の 1 つまた は 複数の シンボルの 名前と アド レ 
スを 表示し ます， 

"く マップ 名〉!" を 入力す る と， コマンド は その シンボル マップの 情報 を 表示し ま 

す. マップ 名 は， 対応す る シンボル ファイルの ファイル 名 （拡張 子な し） でな く 
て はなり ません. 

、、く セグメント 名〉, を 入力す ると， コマンド は その セグメントの 名前と ロード 
セグメント アドレス を 表示し ます • セグメント 名 は， シンボル マップ 内 か， 現在 
開かれて いる シンボル マップ 内に 挙げられ ている 正しい セグメ ントの 名前で なけ 
れば なりません， 

、、〈シンボル 名〉 か を 入力す ると， コマンド は， その シンボルの セグメント ァ ドレ 
スと セグメントの オフセット を 表示し ます. シンボル 名 は， 入力され たセ グメン 
ト 内の シンボルの 名前で なければ なりません. 

複数の セグメ ントゃ シンボルの 情報 を 表示す る 場合， セグメ ン ト名ゃ シンボル 
名に アスタリスク （*) をつ ける ことができます. アスタリスク は， ワイルド カー 

ド 的な 文字と して 働く ので， SYMDEB は， セグメ ン ト名ゃ シンボル 名の 始ま り と 
同じ 文字で 始まる 名前の すべての セグメ ントゃ シンボルに 閱 する 情報 を 表示し ま 
す. たとえば， af* : " は， 文字 *F "で 始まる すべての セグメント 名で あり， め 
は， アンダースコア （ ） で 始まる すべての シンボルです. 
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35 SYMDEB の コマンド 

X コマンドの 使用例 をつ ぎに 示します. 

X 

この 例で は， 現 シンボル マップの 名前と， その マップ 内の セグメ ン 卜の 名前と， 
ロード セグメント アドレスが 表示され ます. ^ ^ 

X？ test! 

こ の 例で は， シ ン ボル マ ップフ アイ ル 、、test" の ロード セグメント アドレスが 表 
示されます. 

X？ igroup: 

この 例で は， 現在 オープン している シンボル マップ 内の、、 igroup" という 名前の 
セグメントの ロード セグメント ァ ドレスが 表示され ます • 

X？ testligroup: • 

この 例で は， シンボル マップな est" 内の "igroup" という 名前の セグメントの 
ロード セグメント アドレスが 表示され ます • 

X？ start 

この 例で は， 現在 オーブン している シンボル マップ 内の シンボル 、、star ビ のセ 
グメン 卜の アドレスと， セグメントの オフ セッ 卜が 表示され ます • 

X？ test'start 

この 例で は， シンボル マップ hes ビ' 内の シンボル 、、start な の セグメ ントの アド 
レスと セグメントの オフ セッ 卜が 表示され ます • 

X？ testligroup: start • 

この 例で は， シンボル マップ、、 test 々内の セグメ ン ト、、 igroup なの シンボル や start ク 
の セグメントの アドレスと， セグメントの オフ セッ 卜が 表示され ます • 

X？ code * 

この 例で は， 現 シンボル マップ 内の 文字 、od ビ で 始まる すべての シンボルの 

セグメントの アドレス 値と オフ セッ ト 値が 表示され ます. 
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Fill 









機 


能 




解 


説 1 



仔 IJ 



F く レンジ〉 く リスト〉 

く レンジ〉 の メモリ を く リスト〉 の 僅で 満たす 

Fill コマンド は， 入力され た 〈レンジ〉 内の アドレスの メモリ を， く リスト〉 の 
値で 满 たします. く リスト〉 の 長さが 〈レンジ〉 よりも 短い とき は， レンジ 内の す 
ベての バイトが 満たされ るまで， 〈リスト〉 が 繰り返して 用いられます. く リスト〉 
の 値が く レンジ〉 の バイ ト 数より 大きい 場合， 



ンドは 余分な 値 を 無視し ます. 



F コマンドの 使用例 をつ ぎに 示します. 



F CS ： 100 L 100 FF 

この 例で は， メモリの CS:100 から CS:1FF までが バイ ト値 FFH で 満たさ 
れ ます. 



F DGROUP: table L 64 42 45 52 54 41 



この 例で は， "DGROUP ： table" から 100 (64H) バイ トカ 仁 入力され た バイ ト 
値で 満たされます. 前記の 5 個の 値 は， 100 バイ 卜すべ てが 一杯になる まで 繰り返 
されます. 
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Go 



1 書 




i 機 


能 




解 


説 



G [= 開始 アドレス] [ブレーク ポイント アドレス] 
デバ ッ グ 中の プログラムの 実行 

Go コ マン ドは， 入力され た 開始 ァ ドレスの プログラムに 実行の 制御 を 渡し ま 
す. 実行 は プログラムが 終わる まで， または ブレーク ポイント アドレスに くるま 
で統 きます. また， プログラム は， Breakpoint Set コマンド を 用いて セットされ 
た ブレーク ボイ ントで 停止し ます. 

開始 アドレス を 省略す ると， コマンド は， CS レジスタと IP レジスタの 現在 値 
が 指定す る アドレスへから 実行 始め ま す. 開始 ァ ドレス を 指定す ると き は， イコー 
ル 記号 （=) をつ けます. 

ブレーク ボイ ント アドレス は， 命令 オペコードの 最初の バイ ト を 指定し ます. 
1 度に/ ritti 10 個の ブレーク ボイ ント アドレス を， 任意の 順序で 入力で きます. 実 
行の 初にく ろ アドレスの み 力;， ブレーク ポイント を 発生 させ， 他 はすべ て 無視 
されます. 10 個より 多い ブレーク ポイント を セットしょう とすると， SYMDEB 
は エラー メ ッ セージ を 表示し ます. 

プログラムの 実行の 際に ブレーク ボイ ン 卜に 達する と， SYMDEB はすべ ての 
レジスタと フラグの 現在 値 を 表示し ます • また， 次に 実行す る 命令の 表示 も 行い 
ます. 表示の 形式 は， Register コマンドと 同じです. 

注意 

Go コマンド は， IRET 命令 を 用いて， プログラムに 制御 を 渡します. そのため， 

Go コマンド は ユーザーの スタック ボイ ントを セットして， ユーザー フラグと CS 

レジスタ 及び IP レジスタ を ユーザー スタックに 入れなくて はなり ません • ユー 

ザ一 の スタック が 6 バイ ト なかった り ， 無効な メモリ 内に ある 場合， Go コマンド 
がォ ペレ— ティ ング システムの 故障 を 引き起こす ことがあります. 

ブレーク ポイント 作成の 際， SYMDEB は， 各 ブレーク ポイント アドレスに 
INT3 命令 （割り込み コード 0CCH) を 置き， ブレーク ポイントが くると， この 
アドレス を 元の 命令に 復元し ます. しかし， 実行が プログラムの 最後まで 続けら 
れ たり， 何 か 他の 理由で 中止され た 場合， SYMDEB は， 割り込み コードの 置換 は 
行いません. このため， プログラム を 再開させる 前に Name コマンドと Load コ 
マンド を 用いて， プログラム を 再 ロードし なくて はなり ません. 
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プログラムが 最後まで 実行され た 場合， SYMDEB は ^Program terminated 
normally" という メッセージ を 表示し ます， 

1 例 I G コマンドの 使用例 をつ ぎに 示します， . • 

G = CS ： 0 CS: 7550 ^ 

この 例で は， アドレス や CS:(T の プログラムに 実行の 制御が 渡されます • 
SYMDEB は， ブレーク ポイント アドレス、、 CS:7550 "の 命令が くると， 実行 を 中 
止して， レジスタと フラグの 現在 値 を 表示し ます. 

G 

この 例で は， CS レジスタと IP レジスタの 現在 値が 示す 命令へ 制御が 渡され ま 
す. この コマンド は 一般に， ブレーク ポイント 後の 実行の 継統に 用いられます. 

G = —main add 

この 例で は， シンボル アドレス main" が 指名す る 命令に 制御が 渡 されます. 
ブレーク ポイント は， アドレス 、、adcT に セット されます. 



3.5 SYMDEB の コマンド 



Help 



□ 



1 機 


能 


解 


説: 



SYMDEB コ マン ドの 一覧表 示 

Help コマンド は， SYMDEB 
をつ ぎに 示します. 



ンドの リス トを 表示し ます. 表示され る リスト 



A 【く aclclress〉】 - assemble 
DC [く bp>】 - clear breakpoi nt ( s ) 
BD 【く hp>】 - disable breakpotnt(s) 
BE【<bp>】 - enable breakpoi nt (s ) 
B し 【<bp>】 - list breakpoint(s) 
DP 【bf>】 く addrc33> - set breakpoi nt 
C <range> <address> - compare 
l)【 type] 【 く range>】 - dump memory 
EC type) <address> 【<llst>】 - enter 
F <range> < 1 1st > - fill 
G 【- く address) 【く address >•••】 】 - go 
\\ 
I 

K 



<value> - Input from 
【く value>】 - stack trace 
C<addr > 【く drl ve><rec><rec>】 】 一 load 



？ <expr> - display expression 
！ CUos comrnarun - shell escape 
• - display current source line 



M <range> <address> - move 

N <f i lenamc> [く menaine〉...】 - name 

0 <value> <byte> - output to port 

P 【-<a<lciress>】 【<value>】 - program step 

Q - quit 

R (<reg>3 C〔》】 <value>】 - register 

S <range> < i 1st > - search 

S - source level debugging 

T 【》<adciress>】 【く value" - trace 

U 【< range >】 - unasserobl e 

V 【<range>〕 - view source lines 

W 【く address) 【く drl ve><rec><rec>】 】 • wiMte 

X 【7】 く syrobol> - examine synibols《s》 

XO く symbol > - open map/segment 

Z く symbol > <value> 

> ) く device/nie> - Redirect output 

く 《 く devlce/Hle> - Redirect Input 

= ~ <devlce/f i le> - Redirect both 
» <stri ng> 一 comment 



く exj>r> ops: ♦ -铸 / : not seg off by wo dw pol port wport mod and xor or 
<type> •• Byte. Word. Doubleword, Asclz, Shortreal . し ongrea し Tcnbylcreal 
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1» 式 I H く 数値 1> <数《2> 
I 機 能 I 16 進数の 和と 差の 計算 

I 解脱 I Hex コマンド は， 2 つの 16 進数の 和 と 差 を 表示し ます. SYMDEB は， 、、数値 T 

と 、、数値 2" を 加算して 結果 を 表示し， 次に や 数値 1" から や 数値 2" を 引いて そ 
の 結果 を 表示し ます. 結果 は， 常に 1 行に 16 進数で 示されます. 一般的な 式 を 評 
価す る 場合 は， "Display コマンド〃 の 項 を 参照して ください. 

1 例 I H コマンドの 使用例 をつ ぎに 示します. 

H 3 4 

この 例で は， 7 と FFFF という 結果が 表示され ます. 

H 110 100 
この 例で は， 210 と 10 という 結果が 表示され ます. 



Hex 
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3.5 SYMDEB の コマンド 



Input 



く ポート〉 



機 能 I 指定した く ポート〉 から 1 バイト 読み込む 



解 蛻」 Input コマンド は， 入力され た 入力 ポートから 1 バイト を 読み込んで 表示し ま 

す. "； 



<5リ 



I コ マン ドの 使用例 をつ ぎに 示します. 



この 例で は， 入力 ポート 番号 、、2F8〃 から 跣み 取った バイ ト 値が 表示され ます， 
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し 03d 



害 


式 




機 


能 


1 解 





L [く アドレス〉 | [く ドライブ〉 く レコード〉 く カウント〉]] 
ファイル または ディスク の 》 理 レコード を 読み込む 



Name コマンド で 指定 された フ アイ ルゃ， 入力 さ れた 数の 論 
理 ディスク レコードの 内容 を メモリに 読み込みます. 内容 は， 入力され たァ ドレ 

ス か デフ オルトの アドレスに コピーされ， BX ： CX レ ジス タの ペアに ロー ドバイ 
ト 数が セッ ト されます. 

ファイル を ロード するとき は， Load コマンド を 使用す る 前に， ファイル 名 を 入 
力し なくて はなり ません. ファイル 名 は， Name コマンド を 用いて 入力で きます 
が， SYMDEB の 起動時に， 名前 を プログラムの ァーギ ュメン ト と して 通しても 入 
力で きます. 

ファイル 名 を 入力 しないと， Load コマンド は， DS が DS レジスタの 現在 値で 
ある 場所, DS ： 5 C の 現在 名 を 使用 します. こ の 場所 は， Name コマンド を 用いて， 
入力され た ファイル 名 や プログラムの ァーギ ュメン ト と して 通された ファイル 名 
を 受け入れます. 

くァ ドレス〉 を 指定す る と， ファイル や セクタの 内容 はこの ァ ドレスから 始ま 
る メモリ に 入れられ， くァ ドレス〉 を 指定し なければ CS: 100 から 始まる メモリ 
に 入れられます. CS は CS レジスタの 現在 値です. 

ディ スク から 直接 論理 レコード を ロード するとき は， 〈ァ ドレス〉， 〈ドライブ〉， 
〈レコード〉， 〈カウント〉 の 値 を 明確に 入力し ます. ドライブ は， 読み取るべき ド 
ライブの 名前で， ドライブ A:(0), ドライブ B:(l), ドライブ C:(2), ドライ 
ブ D: (3) を 表します. レコード は， ドライブから 読み取る 最初の 論理 レコード 
番号で， 1〜4 桁の 16 進数です. < カウント〉 は， ディスクから 読み取る レコード 
数 を 指定し ます， カウント は， 1〜4 桁の 16 進数です. 

注意 

指定した ファイルが .EXE 形 ファイル （拡張 子 を もつ） である 場合， 
Load コマンド は ロード アドレス を. EXE フ アイ ル のへ ッ ダに 入力され たァ ド レ 
スに 直します. つまり， .EXE ファイルの 場合に は， く アドレス〉 の 指定 は 無効で 
す. 

Load コマンド は， ロード を 行う 前に， .EXE ファイルの ヘッダ を 取り除き ま 
す. したがって， 実際に ロード された バイ ト数 は， .EXE ファイルの バイ ト 数と 食 
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い 違います. 

指定した ファイルが .COM 形 ファイル （拡張 子、、 .COM 〃を もつ） である 場合, 
必ず CS:100 から ロードされ ますので， く アドレス〉 を 指定しても 無効と なり ま 
す. 

指名され た ファイル にた HEX" 拡張 子が ある 場合， Load コマンド は， フ アイ 
ルの ロード を 行う 前に， その ファイルの 開始 ァ ドレスと アドレス を カロ 箅 します. 
アドレス を 入力 しないと， ファイル は その 開始 アドレスに ロード されます. 

L コマンドの 使用例 をつ ぎに 示します. 

N file, com 
し 

この 例で は， AfUe.com" という 名前の ファイルが， メモリの アドレス CS:100 
に ロード されます. ロードされ たバイト 数 は， BX:CX レジスタ ペアに 収められ 
ます. 

L DGROUP: table 

この 例で は， シンボル ァ ドレス や DGROUP ： table" から 始まる 記憶 位! H にファ 
ィルが ロード されます. コマンド は， DS:5C の 位置の 現在の ファイル 名 を 使用し 
ます. 

L workspace 2 34 3 

この 例で は， 論理 レコード 番号 52 (34H) から 始まる 3 つの 論理 レコードが メ 
モリの シンボル アドレス "workspace" へ ロード されます. • 
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Move 



L 害 


式 i 






解 





M く レンジ〉 く アドレス〉 
く レンジ〉 で 指定した メモリ ブロック を 〈アドレス〉 へ 移動 （コピー） 

Move コマンド は， く レンジ〉 の 指定す る メモリの ブロック を， く アドレス〉 から 
始まる 位置へ 移動させます. 

すべての 移動 は， ソース ブロックと 宛先 ブロックが 重なっても データ を 損失す 
る ことなく 遂行され ます. 〈レンジ〉 で 指定した アドレスの メモリ は， Move コマ 
ンド 実行 後 も そのまま 残って います. ただし， 宛先 ブロックが ソース ブロックの 
一部と 重なった 場合 は， 元の ソースが 変更され ます. 

デー タ の 損失 を 防 ぐ 為に， Move は， ソース が 宛先 よりも 高位の アドレス にある 
場合， 最初に ソース ブロックの 最も 低位の ァ ドレスから データ を コピーし ます. 
ソース が 低位の アドレスに ある 場合， Move は， 最初に ソースの 最も 高位の ァ ドレ 
ス から データ を コピーし ます. 



M コマンドの 使用例 をつ ぎに 示します < 



CS ： 100 110 CS ： 500 



こ の 例で は， CS ： 100 から CS ： 110 までの レン ジの すべての バイ ト が、 CS ： 500 

から 始まる メモリに 移動し ます. 



M DS ： table L 100 workspace 



この 例で は， シンボル アドレス や DS:table" の 256 (100H) バイ トカ^ アドレス 
"workspace" へ コピー されます. • 
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Name 



I 害 式 I N [く ファイル 名〉] [く 引数〉] 



ファイル 名， 引数の セット 



解 ttt 



Name コ マン ドは， 以後の Load コマンド や Write コマンド のために フ アイ ル 
名 を セット したり， 以後の ロード 済 プログラムの 実行の ために プログラムの 引数 
を セットした りします. 

ファイル 名 を 入力す る と， 以後の すべての Load コマンド や Write コ マン ド 
は， ディスク ファイルの アクセスの 際に この 名前 を 使用し ます. 

引数 を 入力す ると， コマンド は， スペース を 含む すべての 引数 を DS:81 から 始 
まる 記憶 位置に コピーして， DS: 80 の バイ トを コピー された 全文 字数に セッ ト し 
ます. どちらの 場合 も， DS は DS レジスタの 現在 値です. 引数 をい つたん コピー 
すれば， デバッグ 中の プログラム による アクセスが 可能と なり ます. 

注意 

關の 2 つの 引数が フ ァ ィ ル名 である 場合， コマンド は， アドレス DS ： 5C とァ 
ドレス DS ： 6C に ファイル コントロール ブロック を 作成 して， この ブロックに 名 
前 （正しい 形式の 名前） を コピーし ます. これによ つて， デバッグ 中の プロ グラ 
ムが ファイル コントロール ブロック （FCB) を 使用す る ことができます. 

Name コマンド は， ファイル 名 を 引数と しても 扱い， DS:81 へコ ピーしたり， 
DS ： 5C に ファイル 名の ファイル コントロール ブロック を 作成 したりし ます. し 
たがって， Load や Write 用に 新しい ファイル 名 をセッ 卜する と， 前の プログラム 
引数 は 破壊され てし まいます. 

Name コマンド は， つぎに 示す ァ ドレスの メモリ を 変更したり 破壊した りする 
ことがあります. 



DS:5C 
DS:6C 
DS:80 
DS:81 




ノレ コント D 
文字の 総数 

タイプされ たす ベての 文字 



ルコント ロール ブロ ッ ク 

ノレ ブロ ッ ク 
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N コマンドの 使用例 をつ ぎに 示します. 
N file, exe 

この 例で は， 以後の Load コマンド や Write コマンドの 為に， ファイル 名が 
、、f ile 1 • exe^ に セット されます. 

N file2.dat file3.dat ノ m b 

この 例で は， デバッグ 中の プログラム のために プログラムの 引数が セッ ト され 
ます， コマンド は， ファイル、、 file2 .dat〃 と ファイル、、 file3. da ビ 用の ファイル 
コントロール ブロック を 作成し ます • また， コマンドの 頭文字、、 以外の コ マン 
ドライ ン 全体 を DS ： 81 に コピーし ま す. 
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Open Map 



XO [く マップ 名〉 ！] く セグメント 名〉 



シンボル マップ または セグメント を セット 

Open Map コマンド は， アクティブ シンボル マップと セグメント， または その 
どちら か をセッ ト します. 

、、〈マップ 名〉!" を 入力す ると， コマンド は， アクティブ シンボル マップ を 入力 
された マップに セットし ます. 〈マップ 名〉 は， SYMDEB コマンド 行に 指定した 
シンボル ファイルの 中の 1 つの ファイル 名 （拡張 子な し） でな く て はな りません. 

く セグメント〉 名 を 入力す ると， コマンド は， 指名され た セグメントに ァク ティ 
ブ セグメント を セットし ます. く セグメント 名〉 は， 指定され た シンボル マップ 内 
の セグメ ントの 名前で なければ なりません. 



<5リ 



X0 コマンドの 使用例 をつ ぎに 示します. 



XO test! 



この 例で は， シンボル マップた test ヶ が アクティブ になります. 
XO testligroup 

この 例で は， シンボル マップ、、 test ケの セグメント 、、igroup" が アクティブ にな 
り ます. 



XO dgrouo 



この 例で は， 現 シンボル マップの セグメント 、、dgroup" が アクティブ になり ま 



す. 
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Output 



L» 式」 o く ポート〉 く バイ ト〉 



機 能， ポートへの 出力 



解 脱 I Output コマンド は， 入力され た バイ トを 指定され た 出力 ポートに 送ります. 
〈ポート〉 は， 16 ビットの ポート アドレスです. 



例 



0 コマンドの 使用例 をつ ぎに 示します. 



0 2F8 4F 



この 例で は， バイ ト値 4F (16 進） が 出力 ポー 卜 2F8 へ 送られます, 



0 3 21 



この 例で は， バイ 卜 値 21 (16 進） が 出力 ポート 3 に 送られます. 
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3,5 SYMDEB の コマンド 



PTrace 



「書 式 i p [=< 開始 アドレス〉] [く カウント〉] - 
I 機 能 I 割り込み にも 対応した トレース 

I 解 锐 I PTrace コマンド は， 入力され た 開始 ァ ドレスの 命令 を 実行して から， すべての 

レジスタと フラグの 現在 値 を 表示し ます. 表示の 形式 は， Register コマンドと 同 
じです • 

〈開始 ァ ドレス〉 を 指定す ると， PTrace コマンド は その ァ ドレスから 実行 を 開 
始 します. そうでなければ， 現在の CS レジスタと IP レジスタが 示す 命令から 実 
行 を 開始し ます. イコール 記号 （=) は， 開始 アドレス を 入力す る 場合に のみ 用 
いる ことができます. 

く カウント〉 を 指定す ると， コマンド は， その 数の 命令 を 実行す るまで 停止し ま 
せん. コマンド は， 次の 命令 を 実行す る 前に， 個々 の 命令 を レジスタ や フラグの 
現在 値 を 表示し ます. 

注意 

PTrace コマンド は， あらゆる 呼び出し ゃソフ トウ ヱァの 割り込みからの 復帰 
や 実行 を 自動的に 行う こと 以外 は， Trace コマンドと 同じです. Trace コマンド 
は， 呼び出し や 割り込みの 実行 後， 常に 停止して， 実行の 制御 を 呼び出された ルー 
チン 内に 残します. 

I 例 I P コマンドの 使用例 をつ ぎに 示します. 

P = 一 main 

この 例で は， や —main" の 命令が 実行され， レジスタと フラグの 現在 値が 表示 さ 
れ ます. また， 次に 実行す る 命令 も 表示され ます. 

P 

この 例で は， 現 CS レジスタと IP レジスタ が 示す 命令が 実行 されます. 
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第 3 章 SYMDEB: シンボリック デバッグ ユーティリティ 



Quit 



書式 Q 



機 能 SYMDEB の 終了 



解 说 Quit コマンド は， SYMDEB ユーティリティ を 終了 さ せ， MS-DOS に 制御 を 戻 

します. 



JLJ Q コマンド は， 引数な しで 使用し ます. 



Q 



この 例で は， SYMDEB が 終了され ます, 
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3.5 SYMDEB の コマンド 



Redirection 



解 脱 



ぐ 装置 名 
> 装置 名 
= 装置 名 



「機 能 1 入出力の 切り換え 



Redirection コマンド は， コマンド の 入力 と 出力 を 装置 名で 指名 さ れた 装置へ 
切り換えます. 

く コマンド によって， SYMDEB は， 指定 さ れた装 匿 か ら すべての コマンド 入力 
を 読み込みます. ： 

〉 コマンド によって， SYMDEB は， 指定 さ れた装 fi へす ベての コマンド 出力 を 
害き 出します. 

= コマンド によって， SYMDEB は， 指定 さ れた 装置 と 読み込み と 害き 出し を 行 
います. 

装置 名に は， たとえば， つぎの ような ものが あります. 詳しく は 「ユーザーズ 
リ フ アレンス マニュアル」 を 参照して く ださい. 

AUX 補助 入出力 装置 ， 

CON コンソール 

補助 入出力 装！ H (AUX) を 用いる 場合， ボートの ボーレート 他の モード を， 接 
続す る ターミナルに 正確に セッ 卜 しなくて はなり ません. 
—般 に， Redirection コマンド は， スク リーン 画面 を 全面的に 使用す る プロ グラ 

ムを デバッグ する 場合に 用います. 
注 息 



入力 を コンソール 以外に 切り換え ると， |CTRLl +|S| キ一 と ICTRU +ICI キー は 
無効と なります. 

Redirection コマンドの 使用例 をつ ぎに 示します. 



> AUX 

こ の 例で は SYMDEB コ マン ドの 出力が V AUX〃 の 装 » へ と 切り換えられます. 



= AUX 



この 例で は， 



ドの 入力と 出力が 、、AUX〃 へ 切り換えられます. 
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SYMDEB: シ ン ボリ ック デバッグ ユー ティ リ ティ 



Register 



害 


式 




機 


能 




1 解 





R [く レジスタ 名〉 [く 数値〉]] マ 
レジスタ 值の 表示 

Register コマンド は， CPU の レジスタの 内容 を 表示し， その 内容の 新しい 値へ 
の 変更 を 可能に します. 

く レジスタ 名〉 を 入力 しないと， コマンド は 現在の CS レジスタと IP レジスタの 
値が 示す アドレスの すべての レジスタ， フラグ， 命令 を 表示し ます. 

く レジスタ 名〉 を 入力す る と， コマンド は 入力され た レジスタの 現在 値 を 表示し， 
新しい 値 を 催促し ます. レジスタ 名と 値の 両方 を 入力す ると， コマンド は レジス 
タを 入力され た 値に 変更し ます. 

く レジスタ 名〉 は， つぎに 示す うちの 1 つです. 



AX 


BP 


SS 


BX 


SI 


CS 


CX 


Dl 


IP 


DX 


DS 


PC 


SP 


ES 


F 



IP と PC は 同じ レジスタ， つまり 命令 ポインタ を 指名す る ものです. F は， フ 
ラグ レジスタの 名前です. 

レジスタ の 値 を 変更す る 場合 は， Register コ マン ド 入力 時に レジスタ の 名前 と 
値 を 入力し ます. 同様に 値 を 入力 しないと， コマンド は， レジスタ 名， その 現在 
値， そして コロン （：） の プロンプト を 表示し ます. 新しい 値 を タイプして リタ 一 
ン キー を 押してく ださい. 値 を 変更したくない 場合 は， リターン キー を 押す だけ 
で 構いません. 不適切な レジスタ 名 を 入力す ると， コマンド は、、 Bad Register" 
という メ ッ セージ を 表示し ます. 

フ ラ グの値 を 変更す る 場合 は， Register コ マン ド 入力 時に レ ジス タ名ゃ F' を 入 
力し ます. コマンド は， 各 フラグの 現在 値 を 2 文字 略号で 表示し ます. フラグ 
値の 略号の リ ス ト をつ ぎに 示します 



3.5 SYMDEB の コマンド 



フラグ 


セット 


ク リア 


ォ ノ ヾ フ n ^» 


リ V 


IN V 




(象 少） 


UP (増加) 


rtnl r\ 11 プ， 

WJ リ 込み 


I7T /お/ ff4t、 

EI (月 効） 


DI (無効） 


fj 'J 


XT/^ 《れヽ 

NO (負） 


PL は》 


セロ 


ZR 


NZ 


補助 桁 上げ 


AC 


NA 


パリティ 


PE (偶数） 


PO (奇数) 


桁 上げ （キャリー） 


CY 


NC 



コマンド は， 値の リス 卜の 終わりに ハイフン （-) を 表示し ます. ハイフンが 示 
されたら， 変更したい フラグの 新しい 値 を 入力して， リターン キー を 押します. 
フラグの 値の 入力 順序 は 任意です. 値の 間に スペース は 必要ありません. 新しい 
値の 入力され ない フラグ は， 変更され ません. どの フラグ も 変更したくない 場合 
は， リターン キー を 押します. 

1 つの フラグに 対して 複数の 値 を 入力す ると， コマンド は "Double flag!" の 
メッセージ を 表示し ます. 前記 以外の 名前 を 入力す ると， コマンド は， 、、Bad 
Flag!" の メッセージ を 表示し ます • どちらの 場合 も， エラーが 発生す るまでの フ 
ラグの 変更 は 行われ ますが， エラーの フラグと それ 以後の フラグ は 変更され ませ 
に 

R コマンドの 使用例 をつ ぎに 示します. 
R 

この 例で は， CS レジスタと IP レジスタの 指す アドレスの 命令に 加えて， すべ 
ての レジスタと フラグの 値が 表示され ます. 表示 はつぎの ようになります. 

AX = 0E00 BX 二 OOFF CX = 0007 DX = 01 FF SP 二 039D BP = 0000 
SI = 005C DI 二 0000 DS = 04BA ES = 04BA SS 二 04BA CS = 04BA 
IP = Oil A NV UP DI NG NZ AC PE NC 
04BA:0UA CD21 INT 21 

命令 は 最後に 表示され ます. 
R AX 

この 例で は， AX レジスタの 現在 値と， 新しい 値に 対する プロンプトが 表示され 
ます. 表示 はつぎの ようになります. ' 



99 



第 3 章 SYMDEB: シン ボリ ッ クデパ ッグ ユー ティ リ ティ 

AX 0E00 

コロン （：） の 後に 16 ビッ 卜の 値 を タイプし ます. 変更したくない 場合に は， 
リターン キー を 押します. 

RF 

この 例で は， 現在の フラグ 値と 変更 を 求める プロンプトが 表示され ます. 表示 
はつぎの ようになります. • 

NV UP Dl NG NZ AC PE NC - 

フラグ 値の 変更に は， プロンプトの 方法 を 用いなければ なりません. コマンド 
行の 値 は， すべて 無視され ます. 

R IP 100 

この 例で は， IP レジスタが 値 100 に 変更され ます. 
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3.5 SYMDEB の コマンド 



Search 





式 1 


1 機 







s く レンジ〉 く リスト〉 

バイ ト 値の 検索 （サーチ） 

Search コマンド は， 入力され た レンジの メモリ を 捜して， リ ス 卜で 入力され たバ 
イト 値 を 見つけます. リストの バイト を 見つける と， コマンド は， リストの 発生 
アドレス を 表示 します. そう でない 場合 は， 何 も 表示せ ず， SYMDEB のプ ロンブ 
卜が 再び 表示され ます. 

リストの バイ ト数 はいくつ でもよ く， 各 バイ トは スペース か カンマで 区切らな 
ければ なりません. リストが 複数の バイト を 持って いる 場合， ある アドレスから 
始まる バイ ト 力;， リストの バイ トの値 及び 順序に一 致しない 限り， Search は その 

アドレス を 表示し ません. 



ゆ J 



S コマンドの 使用例 をつ ぎに 示します. 



S CS: 



200 41 



この 例で は， バイ 卜 値 41 を 含む CS: 100 から CS: 200 の 範囲の 各 メモリの ァ 
ドレスが 表示され ます. 

S table L 100 ^Fix up" 

この 例で は， 文字列、、 Fix up" を 含む 各 メモリの アドレスが 表示され ます. S コ 
マンド は， シンボル アドレス 、、table" から 始まる 256 (100H) バイ 卜の 範囲 を 捜 

します. • . に I. , 
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Set source Mode 



害 式 S {— | & | +} 



I 機 能 I 命令 コード の 表示 形式の 設定 



Set Source Mode コマンド は， 命令 （インストラクション） コード を 表示す る 
コマンドの 表示 形式 を セットし ます. プラス 記号 （+ ) を 入力す ると， SYMDEB 
は， 表示すべき 命令 （インストラクション） に 対応す る 実際の プログラムの ソー 
ス行を 表示し ます. マイナス 記号 （一） を 入力す ると， SYMDEB は メモリ 内の 命 
令 を 分解して 表示し ます. アン パー サンド （&) を 入力す ると， SYMDEB は， 実 
際の プログラムの ソース 行と， 命令 コードの 両方 を 表示し ます. 

Set Source Mode コマンド は， Register コマンド， PTrace コマンド， Trace 
コ マン ド および Unassemble コマンドが 表示す る 命令に 影響 を 与えます. まず， 
SYMDEB は， 命令 コードの み を 表示し ます. S+ コマンド か S& コマンドが 入力 
されて いて， さらに 行 番号の 情報 を 持つ シンボル ファイルが ロー ド されて いる 場 
合に 限って， SYMDEB は ソース 行 を 表示し ます • シンボル ファイル を ロードして 
いなかったり， シンボル ファイルに 行 番号の 情報が 入って いないと， SYMDEB 
は， 以後の ソース 行 表示の 要求 を 無視し ます. S& コマンド を 入力す ると， 
SYMDEB は， CS ： IP が 指定す る 現在の 命令の アドレス が 行 番号 と 一致す る 場合 
だけ， ソース 行 を 表示し ます. 

ソ ース 行の 形式 は つ ぎの とおり です. 

行 番号： ソース 

ソース 行 は 常に， 命令 コードが 表示され る 前に 表示され ます. 要求され た 行の 
表示の 為に， SYMDEB が 現 ソース フ アイ ルを 変更す る 必要が ある 場合， 
SYMDEB は その 行 を 表示す る 前に 新しい ソースファイルの 名前 を 表示し ます. 

注意 

SYMDEB は， シンボル ファイルの 行 番号の 情報 を 用いて ソース 行 を 表示し ま 
すが， これらの 行 を 表示す るに は， ソースファイルの 実際の ファイル 名に 対する 
プロンプト が 必要に なります. SYMDEB が 初め て ソースファイル を アクセスす 
る 場合， つぎの プロンプト を 表示し ます. 

External file name for マップ 名 (cr for none) ？ 
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3.5 SYMDEB の コマンド 



マップ 名 は シンボル ファイルの ファイル 名です. ソース 行 を 表示す るた めに は， 
対応す る ソースファイルの 名前 を 入力し なければ なりません. ファイル 名に は， 
フ アイ ル名 拡張 子が 必要です. SYMDEB が 指名され た フ アイ ルを 見つけられな 
い 場合 は， 新しい 名前 を 催促し ます. - 

ソース 行の 表示 を 中止したい 場合 は， SYMDEB が ファイル 名の プロンプト を 
表 時した 時点で リターン キー を 押してく ださい. SYMDEB は 実際の ソース 行 を 
中止して， 代わりに マップ 名と 行 番号 を 表示し ます. . 

Set Source Mode コマンドの 使用例 をつ ぎに 示します. 

こ の 例で は， SYMDEB が ソース 行 表示 形式に セット されます. 以後の コマンド 
に対して， SYMDEB は 命令の ソース 行の み を 表示し ます. 

こ の 例で は， SYMDEB が ソース 行と 命令 コー ドの 表示 形式に セット されます. 
以後の コマンド に対して， SYMDEB は， ソース 行と 命令 コードの 両方 を 表示し ま 
す. 
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Shell Escape 



1 害 


式 




機 


能 




解 


言兑 



！ く MS - DOS コマンド〉 

SYMDEB の モードからの， MS-DOS コマンドの 実行. 

Shell Escape コマンド （！） は， SYMDEB の モードから， 直接 MS-DOS の コマ 
ンドを 実行し ます. この コマンド を 用いる と， デバッグ 中で も （SYMDEB を 中止 
せずに）， ディレクトリ を 調べたり する ことができます. SYMDEB は， 指定され 
たく MS-DOS コマンド〉 （内部 • 外部 コマンド 共に） を 実行し， コマンドが 終了す 
ると， 再び SYMDEB の コマンド 入力 モードに 戻ります. 

MS-DOS コマンドの 1 つと して， MS-DOS の コマンド プロセッサ COM- 
MAND.COM 自体 を 指定す る ことができます （この場合， 引数 はっきません）. 
SYMDEB は， メモリへ COMMAND . COM を ロードし， 制御 を こ れへ移 します. 
このと き ユーザー は， 通常の MS-DOS モー ドと 同じ 操作 を 行う こ とがで きます. 
この 状態から， SYMDEB の モードに 戻る とき は， "EXIT" コマンド を 用います. 

参考 

Shell Escape コマンド （！） を 実行す るた めに は， デバッグ 中の プログラムが 
不必要な メモリ を 解放す るよう になって いなくて はいけ ません. MS-DOS コマ 
ンドを 実行す るた めの メモリが 不足す ると， SYMDEB は， そのむ ね を 知らせる 
メ ッ セージ を 表示し ます. 

不必要な メモリ を 解放す るた めに は， プログラムで MS-DOS の ファンク ショ 
ン コール 4 AH (割り当てられた メモリ ブロックの 変更） を 用います. この ファン 
クシ ヨン コールに よって， MS-DOS は， COMMAND . COM を ロードす る メモリ 
領域 を 確保す る ことができます. 同様の こと 力；， LINK (リンカ） の/ 
CPARMAXALLOC スィ ツチで も 行えます. 詳しく は， や MS-DOS プログラマー 
ズ リファレンス マニュアル ヶ を 参照して ください. 

Microsoft C Ver 3.0 以上で 開発した プログラムで， —main 閱 数の 実行 後で 
あれば， 自動的に メモリ は 解放され ます. Microsoft Pascal, FORTRAN Ver 3 . 
30 以上で 開発され た プログラム でも， 最初の プロシージャ （手続き） を 実行 後で 
あれば， メモリ は [き 動的に 解放され ます. SYMDEB 自身 を ロードした^ でも， 
メモリ は 解放され ます. しかし， MASM または 前述の コンパ ィ ラ と 同様の 機能 を 
持たない コンパ ィ ラで 開発した プログラムの デバッグ を 行う とき は， メモリの 解 
放 を 行わない と， Shell Escaspe コマンド （！） は 実行で きません. 
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35 SYMDEB の コマンド 



f 例 I ！ (Shell Escape) コマンドの 使用例 をつ ぎに 示します. 

-! dir b: * . asm 

この 例 は， ドライブ B: の ファイルで， ファイル 名 拡張 子 \ ASM" のつ くも 
のの ディ レク ト リ 情報 を 表示し ます. MS-DOS モードで， 同様の コマンド を 実 
行した ときと 同じ 表示が された のち， 再び SYMDEB の コマンド 入力 モードに 
戻ります. お 鞸 

！ chkdsk b: 

この 例 は， MS-DOS の 外部 コマンド 、、CHKDSK" を 実行す る ものです. ！ 
(Shell Escape) コマンド では， このように 外部 コマンド （ユーザーが 開発した 
もの も 含む） も 実行で きます. 
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553 な SYDEB ： シンボリック デバッグ ユーティリティ 



Source Line 



[r^] • (ピリオド) 



現在の ソース ラインの 表示 



解 鋭 



Source Line コマンド し ） は， 高級 言語に よ る プログラムの デバ ッ グに 用いる コ 
マンドです. たとえば， プログラム を ブレーク ポイントで 停止 させた 時点で， ピ 
リ才ド し） を 入力す ると， そのと きの ソース モード （Set Source Mode コ マン 
ド 参照） に 関係な く， 現在の ソース ライン を 表示し ます. 
なお， この コマンド は， MASM, SYMDEB, SYMDEB と 互換性の 無い コンパ 

ィ ラで 開発した プログラム では 無効です. 



. (Source Line) コマンドの 使用例 をつ ぎに 示します. 



for ( j = 0; i <= SIZE ； + ) 



こ の 例 は， SYMDEB と 互換性の ある， C コンパイラ で 開発 した プログラム をデ 
'マッグ 中の ものです. 
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3.5 SYMDE3 の コマンド 



Stack rrace 



K [〈値〉] 



機 能 I スタック フ レームの 内容の 表示 



解 «» 



Stack Trace コマンド （K) は， 現在の スタック フレームの 内容 を 表示し ます. 
表示され る 項目 は， 現在の プロシージャと， それから コールされ ている プロ シー 
ジャ および 引数です. さらに， 各 プロシージャ を コールし ている， ファイルと ソー 
ス ラインの 行 番号 も 表示され ます. 

パラメータ 〈値〉 が 指定され ると， その 値の 数まで 引数が， 16 進数で 表示され 
ます. 



K コマンドの 使用例 をつ ぎに 示します. 

これ は， デバッグ 中の ある プログラム を 実行し， ブレーク ポイントに 達した と 
ころで， く 値〉 を 指定せ ずに， K コマンド を 入力した 場合の 表示 例です. 



- K 

IGROUP ： _max(0002,0003) form . sample • c ： 7 
IGROUP: main (？) 



この 例で は， 現在の プロシージャ は 、、_max" で， 2 つの 引数、、 2 H ケ と つ H" 
を 取って いる ことが 分かります. また， この プロシージャ ゃ— max" は， ソース 
フ アイ ル、、 sample. c" の 7 行 目の プロシージャ，— main" から コールされ ており， 
^ 一 main〃 の 引数 は 不定で ある こと も 分かります. 

く 値〉 を 指定した 場合の 出力 はつぎの ようになります. 
-K 3 

IGROUP: max (0002, 0003) form. . sample, c: 7 
IGROUP: main (0002, 2 F62, 2EBA) 

一 

この 例で は， プロシージャ や— main" の 引数が， 3 個まで 表示され ています • 
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第 3 章 SYDEB: シンボリック デバッグ ユーティリティ 



Symbol Set 



害 式」 z ぐンン ボル〉 く 値〉 



機 能 シンボリック アドレスに 値 を セットす る 



匚 1 



伊 J 



Symbol Set コマンド は， 指定した シンボルの アドレスへ， 値 を 入れます. 
Z コマンドの 使用例 をつ ぎに 示します. 
-Z close 26 

この 例 は， シンボル 、、close" の アドレスへ， 26h を セットす る ものです. 
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3.5 SYMDEB の コマンド 



Trace 



直 



T [= < 開始 アドレス〉] [く カウンタ〉] 



機 能 I プログラムの 実行と トレース 



Trace コマンド は， 入力され た 開始 アドレスの 命令 を 実行して， すべての レジ 
スタ とフラ グの 現在 値 を 表示 します. 表示の 形式 は Register コマンドと 同じで 
す. 

く 開始 アドレス〉 を 入力す ると， コマンド は， 入力され た アドレスの 命令 を 開始 
します. 入力し ない 場合 は， コマンド は 現在の CS レジスタと IP レジスタが 示す 



命令の 実行 を 開始し ます. 開始 アドレス を 入力す る 場合 は， イコール 紀号 (=) 
が 必要 となります. 

く カウンタ〉 を 入力す ると， コマンド は， その 数の 命令 を^むす るまで ^止し ま 
せん. コマンド は， つぎの 命令 を 実行す る 前に 各 命令の レジスタと フラグの 現在 
値 を 表示し ます. 

参考 

Trace コマンド は， 8086， 8088， 186 または 286 マイクロ プロセッサの ハード 
ウェア トレース モー ドを 使用す るので， ROM (読み取り 専用 メモリ） に 記憶され 
ている 命令 を トレース する こと もで きます. 

T コマンドの 使用例 をつ ぎに 示します. 
T = 一 main 

この 例で は，— main からの 命令が 実行され， レジスタと フラグの 現在 値が 表示 
されます. また， 次に 実行す る 命令 も 表示され ます. 



T 



この 例で は， 現在の CS レジスタの IP レジスタが 示す 命令が 実行され ます, 



T = 011A 10 



この 例で は， 現在の CS セグメントの 011A から， 16 (10H) 個の 命令の 実行 
が 開始され ます • コマンド は， 現在の レジスタと フラグの 値 を 16 回 表示し ます. 



また， トレース 中の 命令の 表示 も 行います， 
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あ 3 な SYDEB ： シン ボリ ック デバッグ ユー ティ リ ティ 



Unassemble 





ま 


機 


能 









U [く レンジ〉] 

メモリ 内容の 逆 アセンブル 



Unassemble コマンド は， デバッグ 中の プログラムの 命令 （インス トラ クシ ョ 
ン） と プログラム 文， または その どちら か を 表示し ます. 表示の 形式 は， Set 
Source Mode コマンド によって セッ ト されて いる 表示 形式に よって 違います. 
表示 形式に は， つぎに 示す ものが あります. 

形式： 逆 アセンブル モード （S — ） 

機能： 命令 コードの 表示. SYMDEB は， 範囲に よって 与えられる アドレスから 
メモリ バイ トを 読み取り， この バイ トを アセンブリ 言語 文に 翻訳し ます. 
その 結果の 文の 形式 は， Assemble コマンドで 定義す る ものと 同じです. 
シンボル マップが プログラム と共に ロードされ ている 場合， ラベル や 変 

数 や 絶対 シンボル を 表す オペラ ン ド は， ァ ド レスで はな く 名前で 表示 さ 

れ ます. mi 

形式： ソース モード （S+) 

機能： プログラムの ソース フ アイ ル 行の 表示. SYMDEB は， 入力 さ れた 範囲の 
命令に 対応す る ソース 行 を 表示し ます. 

形式： ミックス モード （S&) 

機能： ソース 行と 命令 コード の 表示. SYMDEB は， アセンブリ 言語 文の 対応す 
る 各 グループ に対して， 1 行の ソース 行 を 表示し ます. ソース 行 は， ソー 
ス ファイルから 読み取られます. アセンブリ 言語 文 は， メモリ バイト か 
ら 翻訳され ます • 

SYMDEB では， ソース モードの 場合で も， ミックス モードの 場合で も， シンポ 
ル マップが プログラム と共に 口一 ド される ことと， ソースファイルの 行 番号 情報 
がその マップ 内に ある ことが 必要です. プログラムの 入力され た 部分に 対する 行 
番号 情報がない 場合， SYMDEB は 表示 を 行いません. 

任恧 選択の 〈レンジ〉 を 入力す ると， コマンド は， 入力され た レンジ 内の コー 
ド から 作られた 命令 を 表示し ます. レンジ を 入力 しないと， コマンド は， 現在の 
アン アセンブル ァ ドレスの コードの 最初の 8 行から 作られた 命令 を 表示し ます. 
現在の アン アセンブル アドレスと は， 前回の Unassemble コマンド が 表示 し た最 
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3.5 SYMDEB の コマンド 



終 バイ ト （行） の 次の バイ ト （行） の アドレスの ことです. 

逆 アセンブル モー ドと ミックス モー ドを 用いる 場合， SYMDEB は， 8 ビットの 
即時 ォ ぺ ランドの 16 進 値と ASCII 値の 両方 を 表示 します. 16 進 値 は 命令の 一部 
と して 表示され， ASCII 値 は 同じ 表示 行中の セ ミ コロン （ ；） の 直後に 表示され ま 
す. 

8086 ニー モニッ ク コードと， 8087 ニー モニッ ク コードの 表示の みが 可能です. 



U コ マン ドの 使用例 をつ ぎに 示します. 



> 逆 アセンブル モード 



U CS ： 02AD 



この 例で は， アドレス 、、CS: 02 AD" から 8 行 目までの 分解 コードが 表示され 
ます. 表示 は， つぎのようになります. 



1156: 02AD 55 



PUSH BP 



1156: 02AE 
1156: 02B0 
1156:02B3 
1156: 02B6 
1156:02BB 
1156: 02BF 
1156:02C4 



8BEC 

B802C0 

E893FF 



MOV 
MOV 
CALL 



C746FE6100 MOV 
FF0EEC05 DEC 
833EEC0500 CMP 
7C11 JL 



BP, SP 
AX, 0002 
chkstk 
Word Ptr 
Word Ptr 
Word Ptr 
02D7 



[BP-02] ,0061 
[05EC] 
[05EC] ,+ 00 



U —main L OA 



この 例で は， アドレス main なの 10 (16 進の OA) 行の 命令 コードが 表示 さ 
れ ます. 表示 はつぎの ようになります. 



111 



第 3$ SYDEB: シンボリック デバッグ ユーティリティ 



IGROUP: main: 



丄 丄 %J\j • 




OO 


Dl |C U 

rUon 


1 1 • 
丄 丄 00 • 


AO AC 


ttb 匕し 


MOV 


1 1 • 


门ゥ can 


BttU^ し U 


MOV 


1156 ： 


02B3 


f O o i™ r 

E893FF 


CALL 


1 15o ： 


02B6 


C746FE6100 


MOV 


1156: 


02BB 


FF0EEC05 


DEC 


1156: 


02BF 


833EEC0500 


CMP 


1156: 


02C4 


7C11 


儿 


1156: 


02C6 


8 AA 6 FE 


MOV 


1156: 


02C9 


8B1EEA05 


MOV 



BP 

BP, SP 
AX, 0002 
chkstk 

Word Ptr [BP-02] ,0061 

Word Ptr [05EC] 

WordPtr [05EC] ，十 00 

一 main + 2A(02D7) 
AL,[BP-02] 

BX, [05EA] ' 



ソース モード 



U CS:02AD 



この 例で は， プログラム ソースファイルから 8 行の ソース 行が 表示され ます • 
これらの 行 は， アドレス や CS:02AD" から 始まる 命令 コードに 対応し ます • 表 
示 は， つぎのように なります， 

4：{ • 
5: inti; 



6: 

7: 

8: 

9: 

10: 

11 ： 



for(i = 'a,; i < ？; i ++) 
putchar (1); 

for(i = 'A,;i<'z';i++) 
putchar(l); 

for(l ='0，；1 く' g,;l ++) 



U 一 main L 5 



ず 



の 例で は， アドレス 、、― main" から 5 行 目までの ソース 行が 表示され ます. 
表示 はつぎの ようになります. . 



4：{ 

5: 

6: 

7: 

8: 



int i; 

for(i = ，a，；i<'z';i++) 
putchar (1); 
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3.5 SYMDEB の コマンド 



ミ ックス モード 



U CS:02AD 



この 例で は， 、、CS:02AD" から 8 行 目までの 命令 コード 
コードが 表示され ます. 表示 は， つぎのようになります. 

4：{ 

IGROUP:— main ： 
1156:02AD 55 
1156:02AE 8BEC 
- 1156:02B0 B80200 
1156:02B3 E893FF 



PUSH BP 

MOV BP.SP 

MOV AX.0002 

CALL chkstk 



7: for(l = 'a'; 1 ぐ z，； 1 + +) 

1156: 02B6 C746FE6100 MOV Word Ptr [BP-02] ,0061 



U main L 5 



この 例で は， アドレス 、、― main" の 5 行の 命令 コードと プログラム ソースが 表 
示されます. 表示 は， つぎのようになります. 

4：{ 

IGR0UP: — main ： 
1156: 02AD 55 PUSH 
1156: 02AE 8BEC MOV 
1 1 56 ： 02B0 B80200 MOV AX.0002 
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お 3 な SVDP;B ： シンボリック デバッグ ユー ティ リ ティ 



View 



害 


式 




機 


能 



V. [く アドレス〉] 

指定した アドレスから ソース ライン を 表示 

View コマンド は， 高級 言語に よる プログラムに 用いる コマンドで， そのと きの 
ソース モードの 設定 （Set Source Mode コマンド 参照） に 関係な く， 指定した ァ 
ドレスから 始まる ソース ライン を 表示し ます. 

この コマンド を 用いる ために は， ソース プログラム ファイル 中の ソース ライ ン 
の 行 番号に 関する 情報 を 持った シンボル ファイルが 必要で， MASM, SYMDEB, 

SYMDEB と 互換性の 無い コンパイラで 開発した プログラムの デバッグ では， こ 
の コマンド は 無効です. " " 

V コマンドの 使用例 をつ ぎに 示します. 



-V_func 
4：{ 

5: int i 



6: 

7: 

8: 

9: 

10: 

11： 



for (i = ，ざ； i く ，z，； i++) 
putchar (i) ； 

for (i = 'A' ; i < T; i-f +) 
putchar (i) ； 

for (i = '0，；i く' 9';i+ + ) 



この 例 は， c コンパイラ によって 開発した プログラム をデ バック 中の 様子で， 
アドレス ^func" から 始まる ソース ライン を 表示した ものです. 同様の こと 力:, 
FORTRAN や Pascal で 開発した プログラム でも 行う ことができます. 
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3.5 SYMDEB の コマンド 



Write 



* 


ま 


W [く アドレス〉 [く ドライブ〉 く レコード〉 〈カウント〉]] 




機 


能 l 


ファイル または メモリ 内容の デ イス ク への 害き 出 し 












説 


Write コマンド は， 入力 さ れた 記憶 位置の 内容 を 指名 された ファ イノ 


レゃ ディ ス 



ク 上の 入力され た 論理 レコードへ 害き 出します. 

ファイルへ 書き出す 場合 は， Name コマンド を 用いて ファイル 名 をセッ ト し， 
次に Register コマンド を 用いて， BX:CX レジスタの ペア を 害き 出すべき パイ ト 
数に セッ 卜しなくて はなり ません. く アドレス〉 を 入力 しないと， コマンド は， CS 
レジスタの 現在 値で ある アドレス や CS:10(T から 始まる バイ トを コピーし ます. 
く アドレス〉 を 入力す ると， コマンド は， その アドレスから 始まる バイト を コピー 

します. fc 

■ 

注意 

Go コマンド， PTrace コマンド， Trace コマンドが 実行 済の 場合， ロードされ 
た ファイルの フ アイ ル名， 長さお よ び 開始 ァ ドレス を 正しい 値に セットし なくて 
はな り ません. Register コマンド を 用いて BX レジスタと CX レ ジス タ を 修正 し 
て ある 場合， これらの レジスタ も 正しい 値に セッ 卜 しなくて はなり ません. 

ディスク 上の 論理 レコードへ 害き 出す 場合 は， 〈ァ ドレス〉， 〈ドライブ〉， く レコ一 

ド〉 および 〈カウント〉 を 入力す る 必要が あります. く ドライブ〉 は， 害き 出す ベ 

き ドライブ を 指名す る 番号です （通常， 各々 ドライブ A: (0), B: (1)， C: (2)， 

D: (3) を 表します）. く レコード〉 は， データ を 受け取るべき 最初の 論理 レコード 

を 指定す る 1 文字から 4 文字の 16 進数です. く カウント〉 は， ディスクへ 害き 出 
すべき レコード 数 を 指定し ます. 

警告 

ディスク セ クタが 空いて いる こ と を 確かめずに， そこへ データ を 害き 込んで は 
いけません. 予約 セクタ や 専有 セクタへ 害き 出す と， ファイルの 内容， さらに は 
ディスク 全体が 破壊され る ことがあります. 
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第 3 章 SYDEB ： シンボリック デバッグ ユー ティ 



リ ティ 



例 



W コマンドの 使用例 をつ ぎに 示します, 



N table, bin 



R BX 
BX 0100 



iiiiii 



R CX 
CX D43C 
: 0100 

W DGROUP: table 



この 例で は， 256 (100H) バイ 卜が ディスク 上の ^able.bin" という 名前の ファ 
ィルへ 害き 出されます. * き 出すべき バイト は， アドレス、、 DGROUP ： table" か 
ら 始まります. 

W workspace 2 34 3 

この 例で は， レコード 番号 52 (34H) から 3 つ 目までの 論理 レコードが ドライ 
ブ C へ » き 出されます. 害き 出される バイト は， アドレス、、 workspace 〃から 始 
まります. 
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3.6 エラーメッセージ 



3-6 エラ一 メ ッ セージ 

SYMDEB は， 実行で きない コマンド を 見つける と， エラーメッセージ を 表示し ます • 
SYMDEB は， 起きた エラーに 続けて や Error 〃という メッセージ を 表示し ます • 記号 （八） は， 
コマンド 行中の エラーの 正確な 位 匿 を 示す ものです • たとえば， つぎに 示す 表示 は， Dump コ 
マンドの 値の 範囲が 適切で ない こと を 示して います • 

d cs ： 100 0 

- Error 

また， SYMDEB は， 他の エラー メ ッ セージ を 表示して， その エラーの 内容 をく わしく 伝える 
場合 もあります • 表示され る エラーメッセージ をつ ぎに 示します • エラーに よって その エラー 
に 関連した SYMDEB コマンド は 終了し ますが， SYMDEB 自体が 終了す る こと はあり ませ 

に 

Bad Flag! 

フラグが 間違って います. ユーザー は フラグ を 変更し ようとし i した 力;， タイプした 文 
字 は 許容され ている フラグ 値ではありませんでした. 正しい フラグ 入力 値の リ ス ト につ 
いて は， Register コマンド を 参照して ください. 

Too many breakpoints! 

Go コマンドの パラメータ と して 与えられた ブレーク ボイ ン 卜の 数が 10 個 を 越えて い 
ます. 10 個 以下の ブレーク ボイ ントで Go コマンド を 入力し 直して く ださい. 

Bad register 

Register コマンドで， 間違った レジスタ 名が 入力され ました • 正しい レジスタ 名の リス 
卜に ついては， Register コマンド を 参照して く ださい. 

Double flag 

1 つの フラグに 対して 2 つの 値 を 入力し ました. 指定で きる フラグ 値 は 1 つ だけです. 
Register コマンド を 参照して く ださい， 

Breakpoint list or f * 1 expected! 

Breakpoint Clear コマンド， Breakpoint Disable コマンド, または Breakpoint 
Enable コマンドで， ブレーク ポイントの リス トを 入力せ ずに コマンド を 実行し ました • 

Error reading • SYM file 

SYMDEB コマンド 行に 指定した シンボル ファイル 名が， 読み取れませんでした • この 
場合， ファイルの 長さが 0 になる 力、， ディスク エラーが 起きます • 
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付録 SYMDEB の 使用で きる ァセ ン ブラ と コ ン パイ ラ 



SYMDEB/ MAPSYM の シン ボリ ック デバッグ 機能 はつぎに 示す 言語で 記述され た プロ 
グラムに 使用で きます • 



microsoft FORTRAN version 3.0 以上 

microsoft Pascal version 3.0 以上 

microsoft C version 2.0 以上 

microsoft Macro Assembler version 1,0 以上 

microsoft Basic Compiler version 1.0 以上 

Microsoft Business Basic Compiler version 1.0 以上 



SYMDEBZMAPSYM の ソース 行 表示 機能 は， 正しい 行 番号の 情報 を 生成す る コンパ ィ ラ 
で 使用で きます， ソース 行 番号の 情報 を 自動的に 生成す る コンパイラ をつ ぎに 示します， 

microsoft FORTRAN version 3.0 以上 
microsoft Pascal version 3.0 以上 



つぎに， ソー 

示します. 正しい コンパ ィ ラ のスィ ツチに ついては， 各 言語の マニュアル を 参照して ください • 
microsoft C version 2.0 以上 
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し/ B ： ライブラリ マネージャ 



4.1 イントロダクション 

マイクロ ソフト ライブラリ マネージャ ：LIB は， ライブラリ ファイルの 作成， 管理 を 行うた 
めの ユー ティ リ ティです • 

ライブラリ ファイル は， 他の プログラムが 実行時に 必要と する， 1 つ 以上の や オブジェクト 
モジュール * の 集まり （コレクション） です. オブジェクト モジュール は， データ や インスト 
ラ クシ ヨンが アセンブル や コンパイルされ たもので， 他の プログラムと リンクで きる ように 
なって います. . 

ライブラリ は， リンカ： LINK によって 用いられます. LINK は， プログラム 中で 定義され 
ていない ルーチン （外部 参照） を 解析し， それ を ライブラリ ファイルから 捜し出して， 参照 を 
解決し， 実行可能な プログラム を 作成し ます， 



LIB は， 1 つ 以上の や オブジェクト ファイル" の コピー を 取り込んで， ライブラリ ファイル 
を 作成し ます. オブジェクト ファイル は， 1 つの オブジェクト モジュールから 成る もので， 
MASM ゃ髙級 言語 コ ンパ イラで 作成し ます. 

LIB は， ォブ ジヱク トモ ジュール を ライブラリに 追加 • 登録す ると， この モジュール 名をラ 
イブ ラリ ファイルの や ライブラリ 見出し テーブル〃 に 登録し ます. LINK は， ライブラリ ファ 

ィルを 参照 するとき， 先ず この 見出し テーブル を チヱ ック し， 必要な モジュールが 登録され て 
いるか 調べます. 目的の モジュールが 見つかる と， LINK はこれ を 処理 中の プログラムへ コ 
ピーし リンクし ます. 

本章で は， ライブラリ ファイルの 作成 方法， LINK での 処理 効率 を 向上させる 方法， モジュ 
ルの 追加 • 削除' 入れ換え 方法な ど を 解説し ます. ^ 
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4.2 LIB の 起動と 使用方法 

本節で は， LIB の 起動 方法， ライブラリ ファイルの 作成 • 編集 方法 を 解説し ます. 
LIB の 使用方法 は， 3 通りあります. 

1 • コマンド ラインに よる 方法. MS-DOS か ら LIB を 起動す る コマンド ライ ン 上に， ライブ 
ラ リ の 纏 集の 指示 を 含めて しまう 方法です. 

2. コマンド プロンプト による 方法. LIB を 起動した ときに 表示され る コマンド プロンプト 
に 答えながら， 編集 指示 を 行う 方法です. 

3. 応答 ファイル による 方法. 編集 指示 だけ を 収めた" 応答 ファイル〃 を 作って おき， この 
ファイルに 従った 編集 をす るよう に， LIB へ 指示す る 方法です. 

LIB は， ユーザーの 指示に 従った 処理 を 行う とともに， 指示が 不足して いると き は， 必要な 
tff 報の 入力 を 求める コマンド ブロン ブト を 表示 します. 

なお， LIB による 処理 を 中止 するとき は， [5153+ 回 キー を 押します. 

4.2.1 コマンド ラインに よる 方法 

LIB を 起動す るた めの， MS-DOS の コマンド ライン 上で， ライブラリの 編集に 関する 指示 
(パラメータ） も 指定す る 方法です. そのための， コマンド ラインの 害 式 はつぎのと おりです. 

LIB く ライブラリ 名〉 [/PAGESIZE:n] コマンド" • 
[, リスト ファイル 名， 出力 ファイル 名] 

く ライブラリ 名〉 は， 処理の 対象と する ライブラリ ファイル 名です. 新規に 作成す る， 編集 を 
加える ライブラリ ファイル 名 を 指定し ます. なお， ライブラリ ファイル 名の 拡張 子が \ LIB" 
の 場合 は， これ を 省略す る ことができます. 

ZPAGESIZE:n は， 必要に応じて 指定す る スィッチです. これ は， ライブラリの ページ サ 
ィズ （6 . 2 • 6 • ページ サイズの 設定 参照） を 指定す る もので， 指定 を 省略した 場合 は， 自動 
的に ページ サイ ズは 16 となります. 

く コマンド〉 は， LIB に対する 指示です. ライブラリ ファイルに 追加， 削除な ど を 行う モジ ユー 
ル名を 指定し ます. LIB の コマンドに ついては， 、、6. 3 車 LIB の コマンド" を 参照して くださ 
い. 

く リス ト ファイル 名〉 は， ライブラリの クロス リファレンス リス ト ファイル を 作成した いとき 
に 指示し ます. この クロス リファレンス リスト ファイルに は， ライブラリ 中の モジュールの 
PUBLIC シンボル 名カヽ 一^表に なって 収められます. なお， リスト ファイル 名の 指定 はォプ 
シ ヨンで， « 略す ると この ファイル は 生成され ません. 

く 出力 ファイル 名〉 は， LIB で 処理 を 行った 結果 を 収める 新しい ライブラリ ファイル 名です. 
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通常 （出力 ファイル 名 を 指定し なかった 場合)， LIB は 指定した ライ ブラ リ ファイル そのもの を 
編集し ますが， この 出力 ファイル 名 を 指定す ると， 編集の 対象になった ライブラリ は 元の 状態 
で 残され， 編集 （コマンド） が 反映され た 新しい ライブラリ ファイルが 作られます. このく 出 
力 ファイル 名〉 の 指定 は オプションで， 古い （元にす る） ライブラリ ファイル を そのままの 状 
態で 残して おきたい ときに 指定し ます. 

ライ ブラ リ ファイルが カレン ト ディ レク ト リ に 無い 場合 は， ドライ ブ名ゃ パス 名 を 含めて 
ファイル 名 を 指定して ください. 

リスト ファイル 名 を 指定 するとき は， 最後の く コマンド〉 との 間に， 区切り 記号の カンマ （，） 
をつ けます. この 区切り 記号 は， リスト ファイル 名と 出力 ファイル 名の 間に も 必要です. なお， 
リ ス 卜 ファイル 名 を 省略して 出力 ファイル 名 を 指定 するとき は， く コマンド〉 との 間に カンマ を 
2 つ に） 入れます. 

パラメータの 後ろに セミコロン （：） をつ ける と， それ 以降の パラメータ は LIB の 初期設定 
に 従って 処理され ます. セミコロン は コマンド ラインの 最後に つき， セミコロンの 後ろに バラ 
メータ をつ けても 無効と なります. 

例： 

コマンド ラインに パラメータ をつ けて， LIB を 起動す る 例 をつ ぎに しめします. 
LIB lang —heap; 

この 例で， 処理の 対象と なる ライブラリ ファイル はつ ang. lib" です. この ライ ブラ リファイ 
ルの 拡張 子 は ".LIB" なので， これ を 省略して 指定して います. 

ライブラリ に加える 編集 （コマンド） は， 、、一 +heap" で， ライブラリ 中の モジュール、、 heap" 
を 新しい モジュールに 交換し ます. LIB は， この コマンドに 従って， ライブラリ 中の モジ ユー 
ル 、、heap" を オブジェクト ファイル 、、heap.obf の 内容と 置き換えます. 

コマンド ライ ンの 最後に セ ミ コロン （ ： ） がつ いている ので， 〈コマンド〉 より も 後ろの パラ 

メータに 関して は， 初期設定に 従った 処理が 行われます. すなわち， リスト ファイル は 生成 さ 
れず， お^は ライブラリ ファイルに 直接 反映され， 新しい ライブラリ （出力 ファイル） は 作成 
されません. 

つぎの 例 は， パラメータ を一 通り 指定した 場合の ものです， . 
LIB lang 一 + heap, lang. 1st , lang 1 . lib 

この 例 は， 前例と 同様に， ライブラリ 、、lang.lib" の モジュール 、、heap" を 置き換える もの 
です が， リスト ファイル 名と 出力 ファイル 名が 指定され ています. LIB は， クロス リ ファレン 
ス リスト ファイル 、、lan g .lst" を 作成し ます. また， 編集 結果 は， 出力 ファイル langl.lib" 
に 収められ， 編集の 元にな つた ライブラリ や lang. lib" は， 元の 状態の まま 残されます. 
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4.2.2 コマンド プロンプト による 方法 - 

ライブラリ マネージャの 名前、、 LIB 〃だけ を 入力す ると， LIB は， 処理に 必要な 情報の 入力 を 
求める コマンド プロンプト を 表示し ます. コマンド プロンプトに 沿った 入力 方法 は， つぎのと 
おりです. リ ， 

1. MS - DOS の プロンプト （A〉， B〉，'"） が 表示され ている こと を 確かめ， つぎの よう 
に タイプして， リターン キー を 押します. 

• LIB 

LIB が 起動し， ライブラリ 名の 入力 を 求める， 第 1 の コマンド プロンプトが 表示され 
ます. 

Library name: 

2. 作成 *編 集したい， ライブラリ ファイル 名 を タイプし ます. ライブラリ ファイル 名の 拡張 
子が た LIB 〃のとき は， これ を 省略す る ことができます. 新しい ライブラリ ファイル を 
作成す る 場合 も， ここで その ファイル 名 を 指定し ます. ファイル 名 を タイプしたら， リ 
ターン キー を 押します. 

リターン キーが 押される と， LIB は 入力され た 名前の ライ ブラ リ ファイル を 捜します. 
それが 見つからな いとき は， 新しい 名前の ライブラリ ファイル を 作成す るか 否かの 判断 
を 求める， 補助の プロンプト を 表示し ます. これ は， ファイル 名の 入力 ミス を チェック 
する 役割 も 兼ねてい ます. 

Library file does not exist . Create? 

や Yes^ を タイプす ると， 新しい ライブラリ ファイルが 作成され ます. an (/を タイプす 
ると， MS-DOS の コマンド レベルに 戻ります. 

ライブラリ ファイル 名の 入力が 済む と， LIB は， ライブラリに 行う 編集 処理 （オペ レー 
シ ヨン） の 指示 を 求める 第 2 の プロンプト を 表示し ます. 

Operations: 

3. ライブラリに 行う 編集 操作 （コマンド） を タイプして， リターン キー を 押します. 指示 
する コマンドが 多く， 入力 行が 不足す とき は， その 行の 最後に アン パ サンド 記号 （&) 
を タイプして， リターン キー を 押します. LIB は， 同じ コマンド プロンプト を 次の 行に 
表示す るので， コマンドの 指示の つづき を タイプし ます. 

すべての コマンド を タイプしたら， リターン キー を 押します. ライブラリ ファイルの 整 
' 合性 を チェック するとき は， コマンド を タイプせ ずに， リターン キー だけ を 押してく だ 



122 



4.2 LIB の 起動と 使用方法 



さい. リターン キーが 押される と， LIB は， リスト ファイル 名の 入力 を 求める， 第 3 の 
コマンド プロンプト を 表示し ます. 

List file: 

4. 新しい クロス リファレンス リスト ファイルの 名前 を タイプし， リターン キー を 押します. 
クロス リファレンス リス トフ アイ ル名 は， ユーザーが 自由につ ける こ と がで きます. LIB 
は， この ファイル 名の 拡張 子 を 自動的に つける こと はしません. クロス リファレンス リ 
スト ファイルが 不必要な とき は， 何も タイプせ ずに， リターン キー を 押してく ださい. 
ライ ブラ リファイ ルが 新規に 作成され る 場合， 表示され る コマンド プロンプト はこ こま 
でです. 既に ある ライブラリ ファイル を 編集す る 場合 は， つづいて 出力 ファイル 名の 入 
力 を 求める， 最後の プロンプトが 表示され ます. 

Output library : 

5. ライブラリに » 集 を 行った 結果 （出力） を 収める， 新しい ライブラリ ファイル 名 （出力 
ファイル 名） を 入力し ます. ファイル 名 拡張 子 を 省略す ると， LIB は， 自動的に、、. LIB" 
という 拡張 子 をつ けます. 出 カフ アイ ル名を 指定せ ずに リターン キー を 押す と ， LIB は， 
編^した ライ ブラ リファイ ル名を 出力 フ アイ ル 名に 用い ま す. こ の 場合， 編^の 元にな つ 
た ライ ブラ リファイ ルの 拡張 子が 、、 . BAK〃 につけ かえられます. 

出力 ファイル 名 を タイプしたら， リターン キー を 押してく ださい. LIB は， ライブラリの 作 
成 • 編集 処理 を 開始し ます. 



参 考 

第 2 の コマンド プロンプト 以降の 入力で， セミコロン （：） を 入力す ると， それ 以後の 処理 
が、 LIB の 初期設定に 従って 行われます. LIB は， セミコロンが 入力され ると， それ 以後の コ 
マンド プロンプトの 表示 をせ ずに， ライブラリの 編集 を 開始し ます. 

処理に 関係した ファイルが， カレント ディレクトリ 以外に あるとき は， ドライブ 名， パス 名 
を 含めた 正しい ファイル 名 を 指定して く ださい. 

ユーザー は， ライブラリ ファイルの ページ サイズ を 指定す る ことができます. この 指定 は， 
ライブラリ ファイル 名の 指定と 共に 行います. 詳しく は， 4. 2. 6 、、 ライブラリ ページ サイズ 
の 設定" を 参照して ください， 
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例： 

LIB の 表示す る コマンド プロンプトに 沿った， 入力 例 をつ ぎに 示します. 
LIB 

Library File: math 
• Operations: +sin +cos & 

Operations: -hatan -f exp 
List file: 

Output library : mathl 

この 例で は， ライブラリ ファイル MATH. LIB" が 処理の 対象になって います. LIB の 設定 

を 利用して， ここで は 拡張 子 を 省略して， ファイル 名 を 指定して います. 〈コマンド〉 では， 4 
つの オブジェクト モジュール （sin, cos, atan， exp) の 追加が 指定され ています • 各 モジュール 
は， SIN.OBJ, COS . OBJ, ATAN.OBJ, EXP . OBJ という ファイルに 収められ ています. 
コ マン ドの 入力 を 求める， 2 行 目の コマンド プロンプトの 最後に タイプして ある アン パ サンド 
記号 （&) は， コマンド 行 を 拡張する 場合の 例です. このように， ブロン ブト 、、Operations ゾ' 
の 入力 行の 最後に アン パ サンド （&) を タイプして リターン キー を 押す と， 同じ コマンド プロ 
ン ブトが 表示され， 指定したい コマンドの 続き を 入力す る ことができます. この 例で は， クロ 
ス リファレンス リスト ファイルの 出力 を 求めて いないので， この プロンプト に対して は 何も タ 
イブせ ずに リターン キー を 押してい ます. ライブラリ "MATH. LIB" に 4 つの オブジェクト 
モジュール を 追加した 結果 （新しい ライブラリ） は， 、、MATH1.LIB〃 という 名前の ファイル 
に 収められます. 編集の 元にな つた ライブラリ 、、MATH.LIB" は， そのままの 内容で 保存 さ 
れ ます. 

4.2.3 応答 ファイル による 方法 

ファイル 名 や コマンド など， LIB に対する 入力 だけ を 収めた 、、応答 ファイル * を 用意して お 
き， この 応答 ファイルの 内容に 従って 処理 を 進める 方法です. このと きの 入力 は， つぎの よう 
になります， 

LIB @ く 応答 ファイル 名〉 r 

応答 ファイル を 用いる とき は， アット マーク （@) を 先頭に つけて， く 応答 ファイル 名〉 を 指 
定 します. この アット マーク （@) は， 後ろに つづく ファイル 名が （ライブラリ ファイル 名で 
はなく） 応答 ファイル である こと を 表します. また， 応答 ファイルが カレント ディ レク トリ 以 
外に あるとき は， ドライブ 名， パス 名 を 含めて 正しい ファイル 名 を 指定して ください. 
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応答 ファイルの 名前 は， 自由につ ける ことができます. この ファイルの 内容 は， つぎの よう 
な 形式で 作って ください. 

く ライ ブラ リファイ リレ 名〉 [/PAGESIZE:n] 
く コマンド〉 

く クロス リファレンス リス 卜 ファイル 名〉 
く 出力 ファイル 名〉 

応答 ファイル 中の 各行が， 前節で 解説した 各 コマンド プロンプトに 対応して います. くコ マン 
ド〉 が 多く， 1 行に 収まらな いとき は， その 行の 最後に アン パ サンド 記号 （&) をつ けて， 次 
の 行に コマンドの つづき を 書きます. 応答 ファイル を 利用す る 方法で LIB を 起動す ると， 
LIB は， コマンド プロンプトと それに 対応す る 応答 フ ァ ィ ルの 内容 を 表示しながら 処理 を 進め 
ます. 応答 ファイルの 内容が 不足して いると き， LIB は， 該当する コマンド プロンプト を 表示 
し， ユーザーの 入力 を 待って 処理 を 再開し ます. ' 

応答 ファイル 中で も， LIB の 初期設定に 従った 処理 を 指示す る， セミコロン （：） を 利用す 
る ことができます. 

例： 

応答 ファイルの 例 をつ ぎに 示します. 
PLIB 

■f cursor 4- heap 一 heap * stack 
cross . 1st 

この 例で， 処理され る ライブラリ ファイル 名 は や PLIB.LIB" です. コマンド は， モジ ユー 
ル、、 cursor" の 追加， ^heap" の 置き換え， 、、stack" の コピーが 指示され ています. また， クロ 

"cross . 1st" が, 作成され ます. 
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4.2.4 新しい ライブラリの 作成 

新しい ライ ブラ リファイ ルを 作成 するとき は， ライ ブラ リファイ ル 名の 入力で， 希望す るファ 
ィル名 を 指定し ます. 新しい ライブラリの 名前 は， 既に ある ライブラリ 名と 重複し ないように 
つけて ください. 指定した 名前の ファイルが 既に 存在して いると， LIB は， その ファイルが 編 
集され る ものと 判断し ます. 指定した 名前の ファイルが 存在して いない 場合， LIB は， つぎの 
プロンプト を 表示し ます. ' 

Library file does not exist . Create? 

、、Yes" を タイプす ると， 新しい ライブラリ ファイルが 作成され ます. や No" を タイプす ると， 
LIB の 処理が 中止され， MS-DOS に 戻ります. • 

新しく 作成す る ライブラリ ファイルに ついても， ファイル 名と 共に， ページ サイズ を 指定す 
る ことができます. ページ サイズの 指定 を 省略す ると， LIB の 初期設定に 従って， ページ サイ 
ズは 16 バイトに なります. 詳しく は， 4. 2. 6 、、 ページ サイズの 設定" を 参照して ください. 

4.2.5 ライ ブラ リの 整合性の チェック 

ライブラリ ファイル 名 だけ を 指定して， コマンド を 指定 しないと， LIB は， ライブラリの 整 
合性 を チヱ ック します. 

ライブラリ の 整合性 をチ エック するとき は， 、、し IB "に つづいて ラ ィ ブラ リファイ ル名 指定し， 
セミコロン （：） を タイプして， リターン キー を 押します. LIB は， ライブラリ 中の すべての 
モジュールが アクセス できる かどう か 調べます. 調べた ライ ブラ リ 中に なんらかの 問題が あつ 
た 場合 は， エラーメッセージ を 表示し ます. 問題がなかった とき は， 特に メッセージ は 出力 さ 
れず， MS-DOS の プロンプトが 表示され ます. 

例： 

整合性の チヱ ックを 行う 場合の， 入力 例 をつ ぎに 示します. 
LIB math; 

この 例 は， ライブラリ ファイル AMATH.LIB" の チェック を 行う ものです. 

ライブラリの 整合性の チェック を 行う 場合と して は， ファイルの ベリファイ によって， ライ 
ブラ リ 見出し テーブルと 実際の 内容に 差がない こと を 確かめる などが 考えられます. たとえば， 
ライブラリ ファイル を 他の ディスクから コピーした 後な ど， この 整合性の チェック を 行って， 
コ ピーが 正確に 行われた か 否か を 確認す る とよいで しょう. 

なお LIB は， モジュール を 追加 するとき は， 事前に 整合性の チヱ ックを 自動的に 行うよう に 
設^され ています. したがって ユーザー は， モジュール を 追加す る 度に^^ 性 チヱ ックを 行う 
必要はありません， 
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4.2.6 ライブラリ ページ サイズの 設定 

ユーザー は ライ ブラ リ の ページ サイ ズを 設定す る こ とがで きます. ページ サイ ズの 設定 は， 
編集 *作 成す る ライ ブラ リファイ ル 名の 指定 と共に 行い ま す. コマンド ライ ンの害 式 は， つ ぎの 
ようになります. 

LIB く ライブラリ 名〉 ZPAGESIZE: n 

ここで， n が 希望す る ページ サイズで， 16〜32768 の 間の 2 の 乗数 を 指定す る ことができ ま 
す. 

ページ サイズの 設定 は， ライブラリ 中の モジュールの 配置 （配列） を 制御す る ものです. モ 
ジュール は， 常に， ページ サイズ （バイト 単位） の 倍数の 位 蟹から スタート される ように 配置 

されます. ライブラリ を 新規に 作成す ると きの LIB の 初期設定 や， 既に ある ライブラリ のべ 一 
ジ サイズ は， 16 (バイ ト） となって います. 



参 考 

ページ サイズ は， LIB の 採用して いる インデックス 技法と 関連して います. この 方法で は， 
ページ サイズ は 大きい ほど， ライブラリに 多くの モジュール を 登録す る ことができます. しか 
し， ライブラリ 中の 各 モジュール は， 平均 n/2 バイト （n は ページ サイズ） の 無駄な スぺー 
スを 含んで います. したがって， 実用 上 は 小さな ページ サイズの 方が 有益な ことが 多く， ユー 
ザ 一は 可能な かぎり 小さな ページ サイズ を 指定した 方が よいでしょう. 



例： 

ページ サイ ズの 設定 例 をつ ぎに 示します， 
LIB math/PAGESAIZE ： 256 

この 例 は， ライブラリ 、、1^1八171.し18"のぺージサィズを256 (バィ ト） に 設定した ものです. 

4.2.7 クロス リファレンス リス 卜の 生成 ヾ 

LIB に 対し， クロス リファレンス リスト ファイル 名 を 指定す ると， クロス リファレンス リス 
トを 得る ことができます. この クロス リファレンス リストに は， 2 種類の リストが 収められ ま 
す. 第 1 は， ライブラリ 中の すべての パブリック シンボルの リストで， 第 2 は， ライブラリ 中 
のす ベての モジュールの リ ス ト です. 

第 1 の リストに は， すべての シンボルが アルファベット 順に 収められます. 各 シンボル は， 
それ を 参照して いる モジュール 名の 後に 表示され ます. この 部分の 例 をつ ぎに 示します. 
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START main 

SUM add 

SUM2 add 

EXIT error 

第 2 の リストに は， すべての モジュールが アルファベット 順に 収められます • モジュール 名 
は， その モジュール 中で 参照され る アル フ アベ ッ 卜 順の パブ リ ック シンボルの 後ろに 表示され 
ます • この 部分の 例 をつ ぎに 示します. 

main Offset ： 00000200 H Code and data size: 20 H 
START 

add Offset : 00000400 H Code and data size: 20 H 

SUM SUM 2 

error Offset : 00000600 H Code and data size: CH 

EXIT ― 

4.3 し旧 の コマンド 

く コマンド〉 の 指示に 用いる， LIB の コマンドに はつぎの ような ものが あります • モジュール 

の 追加 • 削除 • 置換 は ライ ブラ リ の 編集に 用い， コ ピー • 移動 は 新しい ライ ブラ リ の 作成に 関係し 

た コマンドです • 

コマンド 記 号 

追加 + ^ 

削除 一 
置換 一十 

コピー * illAi s \rftirn 6U 

移動 一 * 

これらの コマンド は， 処理の 対象と なる ォブ ジヱク ト ファイル 名 *ォ ブジェク トモ ジュール 名 
の 先頭に つけて 使用し ます • 
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4.3.1 モジュールの 追加 

害 式 ： な' 

+ 〈オブジェクト ファイル 名〉 

追加 （+ ) コマンド は， オブジェクト モジュール を ライブラリに 登録 するとき に 用います. 
く オブジェクト ファイル 名〉 は， 追加したい モジュール を 収めた ファイル 名です. この ファイル 
の 拡張 子が、、 .OBJ" のとき は， これ を 省略す る ことができます. ファイルが カレント ディ レク 
トリ 以外に 存在して いると き は， ドライブ 名 や パス 名な ど を 含めた， ただしい ファイル 名 を 指 
定 してく ださい. 追加 コマンド を 示す 記号 （+ ) と， オブジェクト ファイル 名の 間に は， スぺー 
ス （空白） を 入れないで ください. 

LIB は， 指定され た才ブ ジヱク ト ファイル を 捜し， これの 内容 を を ライブラリに 追加し ます • 
つづいて， オブジェクト ファイル 名から ドライブ 名， パス 名， ファイル 名 拡張 子 を 取り除き， 
残った 部分の 名前 を ライ ブラ リ 見出し テーブルに 登録し ます. 

なお， モジュール は， 常に ファイルの 後ろへ 追加され ます. 

例： 

ライ ブラ リへ， モジュール を 追加す る 例 をつ ぎに 示します. 
LIB math + sin. obj 

この 例 は， オブジェクト ファイル、、 sin. obf 中の モジュール を ライブラリ 、、math . lib" に 追 
加す る ものです. 

LIB ¥lib¥math +cos, list; 

この 例 は， ¥lib ディレクトリの ライブラリ や ma th .lib" へ， オブジェクト ファイル "cos . obf 
中の モジュール を 追加す る ものです • さらに， クロス リファレンス リスト ファイル、、 ii st " の 作 

成が 指定され ています. 出力 ファイル に関して は， LIB の 初期設定が 用いられます. 
LIB math +A ： ¥src¥atan ； 

この 例 は， カレント ディレクトリの ライブラリ、、 math. lib" へ， ドライブ A •• の サブ ディ レ 
ク トリ *sr ビの オブジェクト ファイル、、 atan.obf 中の モジュール を 追加す る ものです. リス 
卜 ファイル， 出力 ファイル に関して は， LIB の 初期設定が 用いられます. 
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4.3.2 モジュールの 削除 
害 式 

一く モジュール 名〉 

削除 コマンド （一） は， 〈モジュール 名〉 で 指定され たォブ ジヱク トモ ジュール を 指定され た 
ライブラリ ファイルから 削除し ます. 〈モジュール 名〉 は， ライブラリ 見出し テーブルに 登録 さ 
れ ている 名前で， 正確に 指定して ください. 



参 考 

LIB は， コマンド ライン 上の 順番に 関係な く， モジュールの 追加に 先立って， 削除 を 行い ま 
す. したがって， モジュールの 更新 （新 バージョンへの 変更） は， 確実に 行われます • 



例： ？ 
削除 コマンドの 使用例 をつ ぎに 示します. 

LIB math 一 sin 

この 例 は， ライブラリ ファイル 、、math.lib" の， モジュール *sin ケ を 削除す る ものです. 
LIB ¥lib¥math 一 cos, list; 

この 例 は， サブ ディレクトリ 、、li ビの， ライブラリ ファイル、、 math.lib ク から， モジュール 
"cos" を 削除す る ものです • さらに， 編集の 終わった ライブラリ ファイルの， クロス リ ファレ 
ンス リス 卜 ファイル 、、list" を 作成し ます • 

LIB math +a ： ¥src¥atan -atari ； 

, に - 1 

この 例 は， ライブラリ ファイル A mat h. lib" の， モジュール や ata ビを 削除し， ドライブ A ： 
の ディレクトリ 、、src ウ にある オブジェクト ファイル や atan" を 追加し ます • ここで は， 同じ 名 
前の モジュールの 追加が 先に 指定され ています が， LIB は， コマンド ライン 上で 指定され る 順 
港に 閱係 なく， 削除 を 先に 行います. 
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4.3.3 モジュールの 置換 
害 式 

一十く モジュール 名〉 

lii 換 コマンド （― +) は， 指定され た モジュール を ライブラリ ファイルから 削除 するとと も 
に， 同じ 名前の オブジェ ク トモ ジュール ファイル を ライブラリに 追加し ます. 指定す る くモ 
ジュール 名〉 は， ライブラリ 見出し テーブルに 登録され ている 名前で， 正確に 指定して くださ 
い • 

LIB は， まず 指定され た オブジェクト モジュール を ライブラリから 削除し ます. つぎに， 力 
レント ディ レクト リ 中で， 削除した 〈モジュール 名〉 に 拡張 子 、、.OBJ" のつ いた ファイル を 捜 
し， これ を 追加し ます. もし， 該当する 名前の オブジェクト モジュール ファイルが 見つからな 
いとき は， エラーメッセージが 表示され ます. 

例： 

置換 コマンドの 使用例 をつ ぎに 示します. 

LIB math 一 +cos ； 、 

この 例 は， ライブラリ ファイル A mat h. lib ケの， モジュール や cos" を 削除し， オブジェクト 
モ ジ ユール ファイル 、、 cos . 0 bf を 追加し ま す. - 

4.3.4 モジュールの コピー 
害 式 

* く モジュール 名〉 

コピー コマンド （*) は， 指定され た 名前の モジュール を コピーし， 同じ 名前の 才 ブジェク 
トモ ジュール ファイル を 作成し ます. く モジュール 名〉 は， ライブラリ 見出し テーブルに 登録 さ 
れ ている 名前で， 止 確に 指定して ください. 

コ ピーした モジュールが 収められる オブジェ ク ト ファイル 名 は， 〈モジュール 名〉 と 同じ 名前 
で， 拡張 子、、 .OBJ" がつ けられます. また， この ファイル は， カレント ディレクトリに 作成 さ 
れ ます， 



131 



第 4 章 LIB: ライブラリ マネージャ 



例 ： 

コピー コマンドの 使用例 をつ ぎに 示します. - 

LIB math * cos; 

この 例 は， ライブラリ ファイル Amath. lib かの， モジュール^ os" を コピーして， オブジェ 
クト モジュール ファイル Yos.obr を 作成し ます. 

4.3.5 モジュールの 移動 
害 式 

一 * く モジュール 名〉 

移動 コマンド （一 *) コマンド は， 指定され た モジュール を ライブラリ ファイルから 抜き取 
り， オブジェクト モジュール ファイルに 収めます. く モジュール 名〉 は， ライブラリ 見出し テー 
ブルに 登録され ている 名前で， 正確に 指定して ください. 

抜き取った モジュールが 収められる ォブ ジヱク 卜 ファイル 名 は， <モ ジュール 名〉 と 同じ 名 
前で， 拡張 子、、. OBJ" がつ けられます. また， この ファイル は， カレント ディレクトリに 作成 
されます. また， オブジェクト モジュール フ アルに 移された モジュール は， ライブラリから 削 
除され ます. 

例： 

移動 コマンドの 使用例 をつ ぎに 示します. 
LIB math - * cos 

この 例 は， ライブラリ ファイル、、 math .lib" の， モジュール、、 cos" を 抜き取り， オブジェ ク 
トモ ジュール ファイル 、、 CO s.obr に 移します. モジュール 、、cos" は， ライブラリから 削除 さ 

れ ます. • ' 



132 



4.3 LIB の コマンド 



4.3.6 ライブラリの 連結 
書 式 

+ 〈ライブラリ 名〉 

追加 コマンド （+ ) を 用いる と， 編集 を 指定した ライブラリへ， 他の ライブラリ ファイル 全 
体 を 追加す る こと もで きます. 指定す る 〈ライブラリ 名〉 力、 追加す る ライブラリ ファイルで， 
追加す る ライブラリ ファイルく ライブラリ 名〉 の， ファイル 名 拡張 子が、、 .LIB" のとき は， こ 
れを 省略す る ことができます， 

追加され る ライ ブラ リ は， 編集 を 指定した ライ ブラ リの 後ろへ， 既に ある モジュール を 変更 • 
削除す る ことなく 追加され ます. 



参 考 

LIB は， XENIX 方式， ィ ン テル 方式の ライ ブラ リを MS-DOS の ライ ブラ リ へ 追加す る こ と 
もで きます. 



例： 

ライブラリ 単位の， モ ジ ユールの 追加 例 をつ ぎに 示し ま す. 

LIB mathl + math, lib; 

この 例 は， 編集 中の ライブラリ ファイル、、 mathl. lib" へ， ライブラリ ファイル A mat h • lib" 
を 追加す る ものです. 
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5.1 イントロダクション 

プログラム メイン テナ： MAKE は， マクロ アセンブラ や 高級 言語に よる プログラムの 開発 
工程の 保守 • 管理 を 自動的に 行う ユーティリティです. MAKE は， ソースファイルの 更新に 伴 
なって， それから 派生す る プログラムの 更新な ど 必要な 処理 をす ベて 自動的に 実行し ます. 

MAKE の 機能 は， いわゆる バッチ 処理と は 異なり， さらに 高度です. メイン テナ ンスの 目的 
とする ファイル （オブジェ ク ト ファイル， ライブラリ ファイル， クロス リファレンス リスト ファ 
ィル など） と， それの 元になる 関連 ファイル （ソースファイル， クロス リファレンス ファイル， 
ォブジ ヱクト ファイル など） の 作成 日付 を 比較し， 目的 ファイルの 日付が 遅れて いる 場合に だ 
け， 特定の 更新に 必要な 処理 を 実行 します. MAKE は， さらに MAKE に よ る 処理で 生 じた ファ 
ィルの 作成 日付の 食い違い （日付の 遅れ） に関する 処理 も 行います. 

MAKE は バッチ 処理の ように， ファイルが 1 つで も 更新 されれば， すべての ファイルの ァセ 
ン ブル， コンパイル， リンク を 行うよう な こと はしません. MAKE を 使用す る ことによって， 
多くの ソースファイル を 持つ プログラム や， 完成までに 多くの ステップ を 必要と する プロ グラ 
ムの 作成で， かなりの 手間と 時間が 節約され ます. 

つぎの 項で は， MAKE の 使用方法 を 説明し， 例 を 挙げて アセンブリ 言語の プログラムの 保守 
方法 を 示します. 

5.1.1 MAKE の 使用 

MAKE を 使用す る 場合 は， 実行したい 作業 を 定義す る、、 メイク ファイル〃 と， この 作業が 依 
存 する ファイル 、、関連 ファイル〃 を あらかじめ 作成して おきます. 

メイク ファイルが あれば， MAKE を 起動す る 場合， ただ メイク ファイル 名 を 入力す る だけ 

で， 自動的に ファイルの 内容 を 読み取られ， 必要な 処理 を 実行し ます. 
本節で は， メイク ファイルの 作成 方法と， MAKE の 起動 方法 を 説明し ます. 
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5.1.2 メイク ファイルの 作成 

メイク ファイル は， テキスト エディタ を 用いて 作成し ます. ファイル は 1 つまた は 複数の、、 作 
業 記述〃 から 成ります. 記述の 形式 をつ ぎに 示します. 

く 目的 ファイル 名〉 ： く閱連 ファイル 名〉 ••• 

くコ マン ド〉 

目的 ファイル 名 は， 更新 を 必要と する ファイルの 名前です. 関連 ファイル 名 は， 目的 フ アイ 
ルが 依存す る （作業に 必要と なる） ファイルの 名前です. コマンド は， MS-DOS の 外部 コマ ン 
ド です. 

目的 ファイルと 関連 ファイル は， 有効な ファイル 名で なければ いけません. これらの フ アイ 
ルが メイク ファイルと 異なる ディレクトリ にある 場合 は， パス 名 （ディレクトリ 名） を 含めた 
正しい ファイル 名 を 指定して ください. また， 目的 ファイル 名に ドライブの 指定 はでき ません. 

関連 ファイル はいくつ 入力しても よい カ^ 目的 名 は 1 つし か 許されません. 関連 ファイル 名 

は， 1 つ 以上の スペースで 区切らなくて はなり ません. 関連 ファイルが 1 行に はいり きらない 

場合， 行の 終りに 円記号 （¥) を タイプ すれば， 次の 行に 名前 を統 ける ことができます. 
〈コマンド〉 は， MS-DOS の 外部 コマンドで， TYPE や COPY などの 内部 コマンドで はあり 

ません. コマンド は， 複数 指定す る ことができ ますが， 各々 は 必ず 新しい 行から 始め， 先頭に 
タブ か スペース を いれなくて はなり ません. コマンド は， 目的 ファイルの 作成 日付 以後， 関連 
ファイルの 修正が あった 場合に だけ 実行され ます. ' 

メイク ファイルの 中には， 作業 記述 をい くつ いれても かまいませんが， ある 記述の 最終 行と 
次の 記述の 第 1 行との 間に は， 必ず 最低 1 行 空けて 区切らなくて はなり ません. 

注意 

作業 記述 を 害く 順番 は 重要です. MAKE は， 順に 記述 を 調べ， ファイルの 作成 日付に 基づい 
て， 指定され た 作業 を 実行す るか どうか を 決定し ます. 後の コマンドが 目的 ファイル を 修正す 
る 場合， その ファイル を 目的 ファイル とする 前の 作業 記述へ 戻る こと はでき ません. 
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5.1 イントロダクション 

例： 、 , 

メイク ファイルの 例 をつ ぎに 示します. ' 

startup . obj ： startup . asm 

MASM startup, startup, nul, nul 

print . obj : print . asm 

MASM print, print, print, print 

print . ref : print . erf 

CREF print, print 

print . exe : startup . obj print . obj ¥lib¥syscal . lib 

LINK startup+ print, print, print/map, ¥lib¥syscal; 

print .sym: print . map 

MAPSYM 一 I print, map 

この 例で は， 5 つの 目的 ファイル 作成の ための 処理が 定義され ています. 各 ファイル は， ft 
低 1 つの 関連 ファイルと 1 つの コマンド を 持ちます. 作業 記述 は， 目的 ファイルの 作成 順序で 
入力し ます. 例の ように， 必要な 場合 は， 、、print .exe" の 前に Startup, obj" と 、、print • obf 
が 調べられます， 

5.1.3 MAKE の 起動 

プログラム メイン テナ： MAKE を 起動す る コマンド ラインの 形式 はつぎのと おりです. 

MAKE く メイク ファイル 名〉 

〈メイク ファイル 名〉 は， あらかじめ 作成して おいた メイク ファイルの 名前です. メイク ファ 
ィルの 名前 は， 惯例 として， それで 開発す る プログラムと 同じ 名前 をつ けます （拡張 子 はあり 
ません）. メイク ファイル 名 は 自由につ ける ことができます 力、 混乱 を 防ぐ ために， この 慣例に 
従う のが 望ましい でしよう. 

MAKE は 起動され ると， 作業 記述 を 頼に 調べます. 指定され た 目的 ファイルの 日付が その 閱 
連 ファイルの 日付よ り 遅れて いたり， 該当する 目的 ファイルがなかった 場合， MAKE は 指定 さ 
れた コマンド を 表示して 実行し ます. そうでない場合は， 次の 作業 記述に 飛びます. 

指定した メイク ファイル， ま た は 作業 記述 中の 関連 フ アイ ルが 見つか ら なかった と き は， 
MAKE はつぎの ような メッセージ を 表示し ます. -' 

make ： く メイク ファイル 名〉 一 file not found 
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笫 5 な MAKE: 

MAKE がコ マン ド を 実行す ると き， MAKE の 起動時 と 同 じ珮境 変数 を 使用 します. つまり， 
PATH コマンド などに よって 設定され た 環境 変数が， これらの コマンドの 場合 も 使用で きま 
す. 



例： 



make test 



この 例で は， MAKE が ^test" という 名前で 作成され た メイク ファイルから その 命令 を 取り 
出します. - 



5.2 プログラム 保守の 例 

MAKE は プログラムの 開発に， 特に 便利です. MAKE は， ソース プログラムの 修正に 伴う 
—連の 処理 を 自動的に 行い， 修正 さ れた 実行可能 プロ グラム を 素早く 作成し ます. 

つぎに 示す メ ィ ク ファイル は， 実行可能 プログラム lest .exe" の 開発に 使用す る ものです. 
ソースファイル 名 は 、、test . asm" です. こ の 、、test . asm" は， ^nath . lib" という ライブラリ 
ファイル 内の ルーチン を 使用し ます. な est. asm" を 修正す るた びに， その アセンブル リスト， 
クロス リファレンス リス トの 作成， アセンブル された ファイルの ライ ブラ リ との リ ンクが 必要 
となり， さらに SYMDEB で 用いる ための シンボル ファイル を 作成し なければ なりません. メ 
イク ファイル les ビ に 害 かれた 作業 記述と， それ を 実行す る 処理過程 をつ ぎに 示します. 

test . obj ： test.asm 

MASM test, test, test, test 

test • ref : test • erf 

CREF test, test 

test • exe : test . obj ¥lib¥math • lib 

LINK test, test, testZmap, ¥lib¥math ； 



test, sym: test, map 

MAPSYM 一 I test, map 



各行 は， 、、test.obf, 、、test.rer， 、、test.ex ビ， 、、test • sym" の 4 つの 目的 ファイル を 作成す 
るた めに 実行す る 処理 を 定義して います • 

各々 の ファイル は， 少なくとも 1 つの 関連 ファイルと， 1 つの コマンド を 持って います • 作 
Hi! 述は, y 的ファ f ル 作成の 順序で 入力され ます, ゆ J に 示した ように, nest, sym* は LINK 
の 作成す る 、、test.map〃 に， 、、test • exe" は MASM の 作成す る 、、test.crf" に 各々 依存して い 
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5.2 プログラム 保守の 例 



ます. 

ユーザー は， あらかじめ エディタ によって， メイク ファイル" test" と ソースファイル、、 test, 
asm" を 作成し ます. 次に， この メイク ファイル 名 を 指定して MAKE を 起動し ます. このと き 
の コマンド ライン は， つぎのようになります. 

MAKE test 

MAKE が 行う 処理の， 各 ステップ をつ ぎに 示します. 

1. nest . asm'' の 修正 日付と 、、test.exe" の 日付 を 比較し ます. 、、test.exe" の 日付が 遅れ 
ている （または 存在し ない） 場合， MAKE は， つぎの コマンド を 実行し ます. 

MASM test, test, test, test 

それ 以外の 場合 は， MAKE は， 次の 作業 記述へ 進みます. 

2- "test . rer と 、、test • erf" の 日付の 比較. 、、tes し ref" の 日付が 遅れて いる 場合， MAKE 
はつぎの コマンド を 実行し ます. 

CREF test, test 

3. "test . exe" と 、、test， obf の 日付， および ライブラリ ファイル や math . lib,, との 比較. 
"test . exe" の 日付が どちら かの ファイルと 比較して 遅れて いる 場合， MAKE はつぎの 
コマンド を 実行し ます. 

し INK test, test, test/map, ¥lik^math. lib 

4. 、、test.sym" と 、、test . map なの 日付 を 比較し ます. 日付が 遅れて いる 場合 は， つぎに 示 
す コマンド を 実行し ます. 

MAPSYM 一 I test, map 

"test, asm" が 最初に 作成され たと き は， MAKE はすべ ての コマンド を 実行し ます. これ は， 
メイク フ アイ ル 中の すべての 目的 フ ァ ィ ル がない ためです. どの 関連 フ ァ ィ ルも 変更し ないで 
MAKE を 再度 起動させる と， MAKE はすべ ての コマンド を 飛び越します. ライ ブラ リファイ 
ル や math .lib" を 変更して その他の 変更 を 行わない と， MAKE は LINK コマンド を 実行し ま 
す. これ は， "test.exe" の 日付が、、 math, lib" と 比較して 遅れて いるた めです. MAKE は， 
同様に シ ン ボル マ ップ ファイル も 変更し ま すが， こ れは 、、test . map" が LINK によつ て 作成 さ 
れる ためです. 

MAKE はこの ように， フ アイ ルの 作成 日付 を 判断しながら 処理 を 行います. 
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A 

AND(2項演算子••SYMDEB) 48 

ASCII ダンプ 61 

Assemble (A コマンド： SYMDEB) ,50 

B 

BY (単項 演算子： SYMDEB) 48 

BYTE 24 

Breakpoint (SYMDEB コマンド） 

Breakpoint set (BP) 53 

Clear (BC) 54 

Disable (BD) 55 

Enable (BE) 56 

List (BL) 57 

C 

CAPS (表記法） "3 

CODE 23 

Comment ( * コマンド： SYMDEB) 58 

common (結合 タイプ： LINK) 26 

Compare (C : SYMDEB) 59 

D 

DGROP 23 

DOS の セグメント 配列 を 利用 （LINK) 23 

DW (単項 演算子： SYMDEB) 48 

Display (？ コマンド： SYMDEB) 60 

Dump (SYMDEB コマンド） 

Dump (D) 68 

Ascii (DA) 61 

Bytes (DB) • -… 62 

Double words (DD) 64 

Long reals (DL) 66 

Short reals (DS) 65 

Ten-byte reals (DT) 67 

Words (DW) 63 



E 

Enter (SYMDEB コマンド） 

Enter (E) 70 

ASCII (EA) 74 

Bytes (EB) 72 

Double words (ED) 76 

Long reals (EL) 78 

Short reals (ES) 77 

Ten- Byte reals (ET) 79 

Words (EW) • 75 

eXamine symbol map (X コマンド： 
SYMDEB) 80 

F 

Fill (F コマンド： SYMDEB) 81 

G \ 
Go (G コマンド： SYMDEB) 82 

H 

H (16 進数の 表現： SYMDEB) 44 

Help (？ コマンド： SYMDEB) 85 

Hex (H コマンド： SYMDEB) 86 

Input (I コマンド： SYMDEB) 87 

し 

L (対象 レンジ： SYMDEB) 46 

LIB (検索 パス） ii 

LIB 119 

LIB の 起動と 使用方法 

LINK (リンカ） 

LINK の 起動 （コマンド ライン） 

LINK の 動作 方法 

Load (L コマンド： SYMDEB) 



o 9 6 4 8 

2 1 2 8 

1 1 S • ： 
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long 参照 （参照の 解決） 28 

M 

MAKE 135 

MAKE の 起動 方法 137 

memory (結合 タイ ブ） 26 

MOD (2 項 演算子： SYMDEB) 48 

MS-DOS コマンドの 実行 （！ コマンド： 

SYMDEB) 104 

Move (M コマンド： SYMDEB) 90 

N 

NOT (単項 演算子： SYMDEB) 48 

Name (N コマンド： SYMDEB) 91 

near segment-relative 参照 （参照の 解決） '"28 
near self-relative 参照 （参照の 解決） 28 

0 

0(8 進数の 表現： SYMDEB) 44 

OFF (単項 澳算 子： SYMDEB) 48 

OR ( 2 項 演算子： SYMDEB) 48 

Open Map (XO コマンド： SYMDEB) 93 

Output (0 コマンド： SYMDEB) 94 

P 

PAGE 24 

PARA 24 

POI (単項 演算子 : SYMDEB) 48 

PORT (単項 演算子 ： SYMDEB) • ……， 48 

private (結合 タイプ） 26 

PTrace (P コマンド： SYMDEB) 95 

P ト レース 95 

public (結合 タイプ） 26 

Q 

Q (8 進数の 表現： SYMDEB) 44 

Quit (Q コマンド： SYMDEB) 96 

R • 《 

Redirection (く，〉， = : SYMDEB) 97 

Register (R コマンド： SYMDEB) 98 



S 

SEG (単項 演算子： SYMDEB) 48 

SYMDEB の 起動 38 

SYMDEB の コマンド 49 

Search (S コマンド： SYMDEB) 101 

Set Source Mode (S-, S!, S+ : SYMDEB) 

102 

Shell Escape (！ コマンド： SYMDEB) 104 

short 参照 （参照の 解決） 28 

Source Line ('コマンド： SYMDEB) 106 

stack (結合 タイプ） 26 

Stack Trace (K コマンド： SYMDEB) …… 107 
Symbol Set (Z コマンド： SYMDEB) 108 

T 

T (10 進数の 表現： SYMDEB) 44 

Trace (T コマンド： SYMDEB) 109 

U 

Unassemble (U コマンド： SYMDEB) …… 110 
V 

VM • TMP (一時 デ イス ク ファイル） 14 

View (V コマンド： SYMDEB) 114 

WO (単項 演算子 ： SYMDEB) 48 

WORD 24 

WPORT (単項 演算子 ： SYMDEB) 48 

Write (W コマンド： SYMDEB) 115 

X 

X? (SYMDEB コマンド） 80 

XOR (2 項 演算子 ： SYMDEB) 48 

Y 

Y (2 進数の 表現： SYMDEB) • • 44 

ァ 

アット マーク （@) (LIB) •• …… 124 

、 (シンボル） 43 
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アセンブル 50 

新しい ライブラリの 作成 126 

アドレス （SYMDEB) 45 

アドレス 範囲 • 45 

アンダースコア （—） (SYMDEB) 43 

アン パ サンド 記号 （！） （LIB) 122 

依存 ファイル （—関連 ファイル） 135 

—時 ディ スク ファイル （VM • TMP) 14 

移動 （モジュールの 移動） （一 *) 132 

引用符 (ゾ) 47 

エラー メ ッ セージ 一覧 

LINK 178 

SYMDEB 117 

円記号 （¥:MAKE) 136 

澳算 子の 優先 度 (SYMDEB) 48 
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応答 ファイル 

LIB 124 

LINK 10 
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才ーハ ♦ 一 フロー エラー 27 

オフ セッ ト （アドレス） 45 

ォブジ x ク ト コード 5 
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力 
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開発 手順 • 2 

害き 出し 115 

拡張 子 
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• EXE (LINK) 6 
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. MAP (SYMDEB) 40 
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クロス リファレンス リスト 

LIB 128 
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結合 タイプ 26 

検索 （バイ ト 値の 検索） 101 
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85 
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再配置 可能 （一リロ ケータ ブル） 5 
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